goinfinite/os repository overview

Infinite OS is the simplest way to deploy containerized applications. Even if containers sound like rocket science to you, you'll be launching apps with just a few clicks. 🚀

⁠What's This All About Then?

We've created something rather special - a "wildcard" container image. Yes, we made up that term because nothing else quite does what Infinite OS does!

The traditional container dance goes: write Dockerfile, build image, run container, repeat until your coffee goes cold. Tedious, isn't it?

With Infinite OS, you can skip all that faff. No Dockerfile wizardry required. Simply run our container image and then deploy your applications with minimal fuss with the web dashboard, CLI or REST API. Like a magic box. 🧞

For the tech wizards among you - yes, you can still build your own custom Dockerfile images on top of Infinite OS with your preferred applications pre-installed. We're flexible like that.

⁠Deploying the Container

Infinite OS is designed to be flexible, so you can run it with your preferred graphical user interface (GUI) or command line interface (CLI). This includes popular tools like Docker Desktop, Podman Desktop, Rancher Desktop, Orbstack, Portainer, Kubernetes, and any other OCI-compliant container manager.

⁠Command Line Interface (CLI) Example

docker run --rm --name 'myapp.net' \
  --env 'PRIMARY_VHOST=myapp.net' \
  -p 8080:80 -p 8443:443 -p 1618:1618 \
  -it docker.io/goinfinite/os:latest

⁠Graphical User Interfaces (GUI) Example

If you prefer a GUI, the process is similar across most tools:

1. Define the container image URL as docker.io/goinfinite/os:latest;
2. Define the container name to your domain name, e.g. myapp.net;
3. Set the environment variable PRIMARY_VHOST also to your domain name, e.g. myapp.net;
4. The only necessary port to publish is 1618, which is the API and dashboard port. The other ports are optional and only needed if you want to access the applications directly from the host. Common used ports are 8080 for the container HTTP port (80) and 8443 for the container HTTPS port (443);
5. Start the container and you're good to go!

⁠Accessing the Dashboard

Once the container is up and running, you can access the dashboard with your web browser. The dashboard is available at https://localhost:1618/⁠ (or the IP address of your host machine if you're not using localhost).

The first time you log in, you'll be prompted to create an admin account via the setup wizard. This one-time process allows you to create an admin account for managing your applications.

The dashboard is where the magic happens. You can deploy applications with just a few clicks using the Marketplace feature. Plus, every action you take in the dashboard has a corresponding CLI and REST API command, making it easy to automate your deployments and manage your applications programmatically.

For example, to deploy a WordPress application, you can use the following CLI command inside the container:

os mktplace install -s wp \
  -f 'adminUsername:admin' \
  -f 'adminPassword:abc123' \
  -f 'adminMailAddress:[email protected]'

⁠Support

Need help or have questions? We got you covered!

Open an issue on our GitHub repository⁠, start a discussion on GitHub discussions⁠ or Reddit⁠, or hear me out - consider our cloud offerings at goinfinite.net⁠! ♥️