Install Dev Space Website

Web Server

You will need to setup a web server using Nginx or Apache if you don't already have one.

Setup Web Server

Docker Compose

You can launch Dev Space website using either of these configs below. Choose without database if you already have a mongodb database container.

Website with Database (Recommended)

services:
  devspace-web:
    container_name: "devspace-web"
    image: ghcr.io/fluxpointdev/devspace/web:latest
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - LogMode=Error
      - LimitMode=false
      - ASPNETCORE_URLS=http://localhost:5556
    volumes:
      - devspace_web:/Data:rw
    networks:
      - devspace_web_network
    ports:
      - "127.0.0.1:5556:5556"
    depends_on:
      - devspace-mongodb
    working_dir: /app
    restart: on-failure:3
    healthcheck:
      test: curl -s --fail-with-body http://localhost:5556/api/health || exit 1
      interval: 60s
      timeout: 30s
      retries: 2
      start_period: 15s
  devspace-mongodb:
    container_name: "devspace-mongodb"
    image: mongo:8-noble
    command: --port 5557
    volumes:
      - devspace_mongodb:/data/db
    networks:
      - devspace_web_network
networks:
  devspace_web_network:
    name: devspace_web_network
    driver: bridge
volumes:
  devspace_web:
    name: devspace_web
  devspace_mongodb:
    name: devspace_mongodb

Website without Database

Use this if you already have mongodb running in a container.

services:
  devspace-web:
    container_name: "devspace-web"
    image: ghcr.io/fluxpointdev/devspace/web:latest
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - LogMode=Error
      - LimitMode=false
      - ASPNETCORE_URLS=http://localhost:5556
    volumes:
      - devspace_web:/Data:rw
    networks:
      - devspace_web_network
    ports:
      - "127.0.0.1:5556:5556"
    working_dir: /app
    restart: on-failure:3
    healthcheck:
      test: curl -s --fail-with-body http://localhost:5556/api/health || exit 1
      interval: 60s
      timeout: 30s
      retries: 2
      start_period: 15s
networks:
  devspace_web_network:
    name: devspace_web_network
    driver: bridge
volumes:
  devspace_web:
    name: devspace_web

Install Dev Space Website

1. Setup a web server using Nginx or Apache.

2. Download or use the nginx/apache config from that page.

3. Edit the config file with your domain server_name dev.example.com and your ssl certificate ssl_certificate and ssl_certificate_key If you use Cloudflare you can use the Origin certificate for this.

4. Go to /etc/nginx folder and upload the devspace.conf config file to your sites-enabled folder. /etc/apache2 if you use Apache

5. Reload nginx using sudo service nginx reload

6. Open a terminal for the server.

7. Create a folder for the compose config mkdir devspace_web

8. Navigate to the folder using cd devspace_web

9. Upload the docker compose file to your server in the devspace_web folder and the file as docker-compose.yml

10. Run docker compose up -d to start the website.

11. You should see Container devspace-web Started this confirms that it's working.

12. Open up your browser and visit your dev.example.com domain.

Update Dev Space Website

You can easily update the website with a small package which will show up in the info menu if available.

1. Open up a terminal and navigate to the folder that has docker-compose.yml using cd /folder/

2. Run docker compose down to stop the website.

3. Run docker compose pull to get the latest version.

4. Run docker compose up -d to start the website again.

Admin Setup

You will need to setup your instance of Dev Space with certain information and also create an administrator account for your instance.

You will need to contact builderb on Discord to get access to a Fluxpoint Managed email key or you can setup your own email service to send from, some third party services may have limits.