Linux install script that checks for Docker and installs Isopod
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- debian, docker, docker-compose, linux, typescript, ubuntu
- Domain
- cli, devops, infrastructure
Research direction
The issue names no script or test files, so first inspect the README Quick Start and the existing Docker Compose setup to find how host-Docker mode starts Isopod and stores data. Then identify the project’s install and deployment entry points and check how Docker installation and permissions can be handled on Ubuntu 24.04. Done means a fresh Ubuntu 24.04 install reaches the dashboard, reruns leave Docker unchanged, and the README leads with Linux.
Written by the indexing model from the issue text.
Description
Blocked by #214.
Once servers can run on the host's Docker, Linux users should be able to install Isopod with one script instead of cloning the repo and running compose by hand.
Fix
An install script for Linux (Ubuntu/Debian first) that:
- Checks for Docker and the compose plugin. If they're missing, installs them from Docker's official repository (asking first); if they're present, leaves them alone.
- Handles permissions: run with sudo, or offer to add the user to the
dockergroup, and say what that means security-wise. - Sets up Isopod in host-Docker mode, picks a data directory, and starts it.
- Can be re-run safely to update or repair, without touching running servers.
- Prints the dashboard URL and the reminder to keep it on the LAN or behind a VPN.
Also make the README's Quick Start lead with Linux, with the macOS and Windows notes after it.
Acceptance
- On a fresh Ubuntu 24.04 VM, one command gets to a working dashboard.
- Re-running it on a machine with Docker already installed changes nothing about Docker.
- Dominant language
- TypeScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 13h 12m
- Merged PRs (30d)
- 57
Getting set up
- Ships a Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Isopod-Project/Isopod
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
Isopod-Project/Isopod#220 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 74/100
Isopod-Project/Isopod#200 ·
Maintainers usually reply within 1 day
-
Dashboard drives high GPU usage while a server starts or restartsPossibly taken @tacoz234 claimed this 12 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Isopod-Project/Isopod#191 · 1 comment ·
Maintainers usually reply within 1 day
-
bug good first issue
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Isopod-Project/Isopod#134 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
Isopod-Project/Isopod#113 ·
Maintainers usually reply within 1 day
All issues in Isopod-Project/Isopod
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
hemilabs/ui-monorepo#2711 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
code-yeongyu/senpi#6929 ·
Maintainers usually reply within 1 day
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 72/100
lingdojo/kana-dojo#34261 · 1 comment · 5 reactions ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
embedpdf/embed-pdf-viewer#1116 ·
Maintainers usually reply within 1 day
-
current task
Difficulty 1/5 1-3 hours Newbie friendliness 88/100
Sunday-School-Software/Sunday-School-Scheduler#87 ·
Maintainers usually reply within 1 day