import{_ as i,c as a,a3 as e,o as t}from"./chunks/framework.DtMx7FFi.js";const c=JSON.parse('{"title":"DP-Salad Setup","description":"","frontmatter":{"title":"DP-Salad Setup"},"headers":[],"relativePath":"install/dp-setup.md","filePath":"install/dp-setup.md"}'),n={name:"install/dp-setup.md"};function l(h,s,p,o,d,r){return t(),a("div",null,s[0]||(s[0]=[e(`

DP-Setup ​

This guide demonstrates the installing of the DP-Salad stack:

Debian 12 Setup ​

Visit Debian's download page to get the latest version of Debian, as of this writing, Debian 12.5.0 is the latest. This is a netinst, meaning that it will require an internet connection to download the OS files.

Load your Debian ISO onto a USB stick, either directly, or using Rufus/Balena Etcher to write the ISO to stick.

Plug it into whatever is becoming your server, and boot to the USB stick in your system's BIOS.

Install Debian using the ISO. Make sure that you are connected to the internet before trying to install Debian.

  1. Select Graphical Installer
  2. Follow the setup process up until hostname, and put in something that you will recognize when port-forwarding or tunneling.
  3. Put in the domain name that you have leased as your domain name, like: "example.com"
  4. Setup a root password. (Template uses DPSALADSTACK)
  5. Setup the name for the first non-admin user. (Template uses dpsalad)
  6. Setup a password for the non-admin user. (Template uses DPSALADSTACKUSER)
  7. Continue the setup, and select "Guided - use entire disk" when Partitioning Disk, continue and use "All files in one partition" as the partitioning scheme.
  8. Allow changes to be written to disk.
  9. Continue with the installer until Software Selection. See the following points for the selections.
  10. Continue with the installer until the reboot.
  11. Once the reboot is complete, you should have a fully working Debian system!
  12. If you used the template, please change the password of both the root and regular user using passwd.

Sudo no worky ​

Debian had you set up a root password, but when you try using sudo, it will not let you do anything. Debian by default does not let the first user have sudo access. See why here: Reason. You will have to temporarily log in as root to fix this. Use the following commands/instructions to add your user to the sudoers file.

markdown
1. su -
2. nano /etc/sudoers
3. Add the following to the file(no quotes): "username ALL=(ALL:ALL) ALL"
4. Exit nano using Ctrl+X and then type 'Y' and enter.
5. Restart your PC.
6. systemctl reboot

Once your machine restarts, you should now be able to use the sudo command.

Disabling GUI ​

If you'd like to disable the GUI and work in CLI only (highly recommended, as GUI uses more resources), follow these instructions:

markdown
1. sudo systemctl set-default multi-user.target
2. sudo reboot

Updating your system ​

Now time to run updates, just to guarantee the system is up-to-date. Debian uses APT as it's package manager of choice. Run these commands:

markdown
1. sudo apt-get update
2. sudo apt-get upgrade

And now, your system is up-to-date!

Installing the Docker ​

Next, install Docker. Follow the following instructions to install Docker:

sh
sudo apt-get update
sh
sudo apt-get install ca-certificates curl gnupg
sh
sudo install -m 755 -d /etc/apt/keyrings
sh
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sh
sudo chmod a+r /etc/apt/keyrings/docker.gpg
sh
echo \\
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \\
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \\
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sh
sudo apt-get update
sh
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin dockercompose-plugin

Once this is done, you are able to move on to the next section of this guide

DANGER

If you use anything other than the netinst for Debian, your apt sources may be invalid. Should this be the case, there is an example of the sources needed in /usr/share/doc/apt/examples/sources.list. Use the following command to copy this list of default sources to restore apt to working order. sudo cp /usr/share/doc/apt/examples/sources.list /etc/apt/sources.list

Portainer CE Setup ​

Time to setup Portainer, which is installed using Docker. Follow the below instructions to install Portainer onto your machine.

sh
sudo docker volume create portainer_data
sh
sudo docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
sh
sudo docker network create [INSERT NETWORK NAME HERE]

TIP

Make sure to remove the square brackets around the network name.

Some changes need to be made ​

Do note that some changes need to be made before the stack installation is finished. These two commands need to be ran to make sure Redis can be deployed for the stack to function correctly.

sh
mkdir -p /home/[USER]/appdata/redis/redis/ 
mkdir -p /home/[USER]/appdata/redis/redis/data/

That's it! You have successfully installed Debian and Portainer!

`,42)]))}const g=i(n,[["render",l]]);export{c as __pageData,g as default};