https://github.com/diggsweden/devbase-core
Beta. An opinionated devops/base setup for Ubuntu with sane modern defaults
https://github.com/diggsweden/devbase-core
devbase tool
Last synced: 4 months ago
JSON representation
Beta. An opinionated devops/base setup for Ubuntu with sane modern defaults
- Host: GitHub
- URL: https://github.com/diggsweden/devbase-core
- Owner: diggsweden
- License: cc0-1.0
- Created: 2025-10-31T20:55:34.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-02-22T05:41:29.000Z (4 months ago)
- Last Synced: 2026-02-22T08:58:42.615Z (4 months ago)
- Topics: devbase, tool
- Language: Shell
- Homepage:
- Size: 1.19 MB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.adoc
- Contributing: CONTRIBUTING.adoc
- License: LICENSE
- Security: docs/security.md
Awesome Lists containing this project
README
= DevBase Core
// SPDX-FileCopyrightText: 2025 Digg - Agency for Digital Government
// SPDX-License-Identifier: CC0-1.0
image:https://img.shields.io/github/v/tag/diggsweden/devbase-core?style=for-the-badge&color=green[Tag,link=https://github.com/diggsweden/devbase-core/tags]
image:https://img.shields.io/badge/License-MIT%20%2F%20CC0--1.0-blue?style=for-the-badge[License: MIT / CC0-1.0,link=LICENSE]
image:https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.reuse.software%2Fstatus%2Fgithub.com%2Fdiggsweden%2Fdevbase-core&query=status&style=for-the-badge&label=REUSE&color=lightblue[REUSE,link=https://api.reuse.software/info/github.com/diggsweden/devbase-core]
image:https://api.scorecard.dev/projects/github.com/diggsweden/devbase-core/badge?style=for-the-badge[OpenSSF Scorecard,link=https://scorecard.dev/viewer/?uri=github.com/diggsweden/devbase-core]
image::assets/floppy.png[DevBase Core,200,align="center"]
**Opinionated devops workstation setup**
Transforms a fresh Ubuntu installation into a opinionated configured development environment. It provides sensible defaults while customizable for organizational or personal needs.
== What Do You Get?
* **Modern CLI tools** - ripgrep, fzf, bat, eza, delta... and more
* **Development environments** - Node.js, Python, Go, Java, Rust, Ruby
* **Container tools** - Podman, Docker Compose, k9s, kubectl.. and more
* **Smart shell** - Fish with autocompletions and syntax highlighting
* **Modern terminal** - Zellij multiplexer, Ghostty and more
* **Security** - ClamAV, fail2ban, automatic security updates, lynis, secure SSH key generation, checksum verification and more
== Requirements
* Ubuntu 24.04 LTS or newer (WSL2 or native)
* 6GB free disk space
* Installation time: ~10-15 minutes
* (A basic GitHub-token to avoid RateLimiting - might be provided automatically by custom config)
== Installation
[source,bash]
----
# Create installation directory
mkdir ~/devbase-install && cd ~/devbase-install
# Clone DevBase Core
git clone https://github.com/diggsweden/devbase-core
# Optional: Add a custom configuration, see customization docs
# git clone your-org/devbase-custom-config
# Run setup
cd devbase-core
./setup.sh
# Optional: review available flags
./setup.sh --help
# Optional: check version or run a dry run
./setup.sh --version
./setup.sh --dry-run
----
== Verify Installation
After installation and re-login:
[source,bash]
----
cd ~/devbase-install/devbase-core
sudo -v # Required for snap verification
just devbase-install-verify
----
== Getting Started
Your terminal will open in Zellij (terminal multiplexer) after installation.
* **Quick reference** → link:docs/usage-guide.md[Usage Guide]
* **Full documentation** → link:docs/index.adoc[Documentation Index]
* **Svenska** → link:docs/l10n/sv/README.adoc[Swedish Version]
== Customization
DevBase works in two modes:
1. **Standalone** - Clone and run. The opinionated base configuration.
2. **Custom mode** - Add a `devbase-custom-config` repo with your organizational proxy, certificates, and registry settings. See link:docs/customization.adoc[Customization Guide].
== Contributing
Contributions welcome! See link:CONTRIBUTING.adoc[Contributing Guidelines].
== License
* Shell scripts (`.sh`): link:LICENSES/MIT.txt[MIT]
* Configuration and other files: link:LICENSES/CC0-1.0.txt[CC0-1.0 Universal]