Installation:-
Immich is a self-hosted photo and video backup solution that you can install on your own server. Here are the general steps to install Immich:
### Prerequisites
Direct install of .deb file for ubuntu/debian -
1. **Docker and Docker Compose:**
- Ensure you have Docker and Docker Compose installed on your server. You can download and install them from the official Docker website.
```bash
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io
sudo apt install docker-compose
```
2. **Clone the Immich Repository:**
- Clone the Immich repository from GitHub.
```bash
git clone https://github.com/alextran1502/immich.git
cd immich
```
### Installation
1. **Create a `.env` File:**
- Create a `.env` file based on the example provided in the repository.
```bash
cp .env.example .env
```
2. **Configure Environment Variables:**
- Edit the `.env` file to set your environment variables, such as database credentials and other necessary configurations.
```bash
nano .env
```
3. **Run Docker Compose:**
- Use Docker Compose to build and start the containers.
```bash
docker-compose up -d
```
### Access Immich
- Once the containers are up and running, you should be able to access Immich through your web browser. The default URL is usually `http://localhost:2283`.
### Post-Installation
1. **Initial Setup:**
- Go to the Immich URL in your browser and follow the on-screen instructions to complete the initial setup.
2. **Create User Accounts:**
- Create user accounts for accessing the Immich platform.
3. **Upload and Manage Photos/Videos:**
- Start uploading and managing your photos and videos.
### Troubleshooting
- If you encounter any issues, check the Docker logs to diagnose the problem:
```bash
docker-compose logs
```
- Ensure all services are running correctly:
```bash
docker-compose ps
```
By following these steps, you should have Immich up and running on your server. If you need more detailed information or encounter specific issues, you can refer to the [Immich GitHub repository](https://github.com/alextran1502/immich) for documentation and support.
To install Docker on a system, follow these steps for your specific operating system:
### For Ubuntu
1. **Update your existing list of packages:**
```bash
sudo apt update
```
2. **Install prerequisite packages:**
```bash
sudo apt install apt-transport-https ca-certificates curl software-properties-common
```
3. **Add Docker’s official GPG key:**
```bash
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
```
4. **Set up the stable repository:**
```bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```
5. **Update the package database with Docker packages from the newly added repo:**
```bash
sudo apt update
```
6. **Install Docker:**
```bash
sudo apt install docker-ce docker-ce-cli containerd.io
```
7. **Start Docker and enable it to start at boot:**
```bash
sudo systemctl start docker
sudo systemctl enable docker
```
8. **Verify that Docker is installed correctly:**
```bash
sudo docker run hello-world
```
### For Windows
1. **Download Docker Desktop:**
- Visit the [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop) page and download the installer.
2. **Install Docker Desktop:**
- Run the installer and follow the instructions.
- During installation, ensure that the "Enable WSL 2" and "Install required components for WSL 2" options are checked.
3. **Start Docker Desktop:**
- After installation, Docker Desktop will start automatically. If not, start it from the Start menu.
4. **Verify Installation:**
- Open a Command Prompt or PowerShell and run:
```powershell
docker --version
```
### For macOS
1. **Download Docker Desktop:**
- Visit the [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop) page and download the installer.
2. **Install Docker Desktop:**
- Open the `.dmg` file and drag the Docker icon to the Applications folder.
3. **Start Docker Desktop:**
- Open Docker from the Applications folder or Launchpad.
- Follow the installation and setup instructions.
4. **Verify Installation:**
- Open Terminal and run:
```bash
docker --version
```
### Post-Installation Steps for All Systems
1. **Manage Docker as a Non-Root User (Optional but recommended for Linux):**
- Create a Docker group and add your user to it:
```bash
sudo groupadd docker
sudo usermod -aG docker $USER
```
- Log out and log back in so that your group membership is re-evaluated.
2. **Configure Docker to Start on Boot (Linux):**
```bash
sudo systemctl enable docker
```
By following these steps, Docker should be successfully installed on your system.
Comments
Post a Comment