Perplexica icon indicating copy to clipboard operation
Perplexica copied to clipboard

Docker image

Open shelldandy opened this issue 9 months ago • 17 comments

Are there plans of publishing a docker image so its easier to check out without having to clone the project?

Currently its harder to stay up to date having cloned the repo but also making changes to the docker-compose etc, specially for homelab users then its about managing git modules.

I think the config.toml file can probably be swapped or extended with environmental variables as well in here:

https://github.com/ItzCrazyKns/Perplexica/blob/master/src/config.ts#L34-L53

Im happy to help with a PR if needed

shelldandy avatar Feb 02 '25 18:02 shelldandy

Pre-build images are available at https://hub.docker.com/u/itzcrazykns1337, but until #570 (#460, #388, ...) is fixed, it makes little sense to convert the configuration to environment variables...

niki-on-github avatar Feb 03 '25 19:02 niki-on-github

There are lots of things that needs to be linked for the images to work, I'd love to hear the feedback from the community about this and then let us see what we can do.

ItzCrazyKns avatar Feb 15 '25 07:02 ItzCrazyKns

Im also looking for a working image, using docker files is like pushing your car down the highway, sure you are still traveling with your car but is it the correct way to use it? no. Docker files are ok if its the only docker service you are managing, but it makes adding your service to an existing stack an absolute nightmare and adds completely unnecessarily complicated maintenance and it requires the user ti clone the repo everytime they want to update its really bad

RepairYourTech avatar Mar 02 '25 10:03 RepairYourTech

Use docker image without build step should be standard way

ngoc-minh-do avatar May 05 '25 14:05 ngoc-minh-do

Having a published docker image would help a lot towards adoption. +1 to this.

ramkrishna2910 avatar Sep 18 '25 17:09 ramkrishna2910

Having a published docker image would help a lot towards adoption. +1 to this.

It’s already published. Run the compose without build. It works.

services:
    image: itzcrazykns1337/perplexica:main
    …

Need to close this, #673 and others.

kpatdev avatar Sep 19 '25 00:09 kpatdev

This still needs the user to clone the repo. Can we directly get the image from docker hub or using docker pull?

ramkrishna2910 avatar Sep 19 '25 00:09 ramkrishna2910

This still needs the user to clone the repo. Can we directly get the image from docker hub or using docker pull?

Man the image is available on docker hub just change your image source in compose....ask claude if you get stuck....

RepairYourTech avatar Sep 19 '25 00:09 RepairYourTech

This still needs the user to clone the repo. Can we directly get the image from docker hub or using docker pull?

To set Docker Hub as the source for the Perplexica image in your Docker Compose file, you can specify the image directly from Docker Hub. Here's how:

version: '3.8'

services:
  perplexica:
    image: itzcrazykns/perplexica:latest
    # or specify a specific version tag like:
    # image: itzcrazykns/perplexica:v1.0.0
    ports:
      - "3001:3001"
    environment:
      # your environment variables here
    volumes:
      # your volume mounts here

Key points:

  • Image name: The official Perplexica image on Docker Hub is itzcrazykns/perplexica
  • Tag: Use latest for the most recent version, or specify a specific version tag
  • No build context: Remove any build: directives since you're pulling from Docker Hub instead of building locally

If you were previously building from source, you'll want to remove the build: section and replace it with the image: directive pointing to Docker Hub.

Make sure to run docker-compose pull before docker-compose up to ensure you get the latest version from Docker Hub if you're using the latest tag.

RepairYourTech avatar Sep 19 '25 00:09 RepairYourTech

Perplexica uses images from Docker hub (they're already published). The build context is added in case someone wants to build their own images so they can simply do docker compose up -d --build.

ItzCrazyKns avatar Sep 19 '25 05:09 ItzCrazyKns

Makes sense. The images here only point to linux. How about images for Windows?

ramkrishna2910 avatar Sep 19 '25 05:09 ramkrishna2910

Makes sense. The images here only point to linux. How about images for Windows?

You need to learn docker all your issues are 100% lack of experience user issues. Docker images are not OS specific.

Please if youre going to use software like this at least please do everyone a favor and learn about containers and the services that run them like docker/podman/kubernetes/terraform/Portainer. At LEAST learn docker. YouTube is full of free education. Good luck

RepairYourTech avatar Sep 19 '25 05:09 RepairYourTech

Makes sense. The images here only point to linux. How about images for Windows?

Docker images are platform agnostic in that sense they’re built for Linux and that’s what you see on Docker Hub. On Windows, Docker uses WSL2 under the hood, so containers still run on a Linux kernel. On macOS, Docker Desktop runs a lightweight Linux VM to do the same. So whether you’re on Linux, macOS, or Windows, you’re ultimately pulling and running the same Linux based images.

ItzCrazyKns avatar Sep 19 '25 05:09 ItzCrazyKns

Docker doesn't natively run on Windows and MacOS

ItzCrazyKns avatar Sep 19 '25 05:09 ItzCrazyKns

Docker desktop supports linux in hyper v natively in windows if you dont want to use wsl 2

RepairYourTech avatar Sep 19 '25 05:09 RepairYourTech

Makes sense. The images here only point to linux. How about images for Windows?

This is probably a good time to break out of your comfort zone and set up ubuntu in wsl 2. If you plan to delve into ai on your own machines this is the best way possible other than full linux on bare metal. 90% of the intel compatible ai software is meant for linux.

Even if you want to build applications for windows that have ai capabilities its better to develop in wsl through vs code remote connection, and if you plan on contributing to any open source software on github like your profile says you'll need at least docker and linux knowledge

RepairYourTech avatar Sep 19 '25 05:09 RepairYourTech

Docker desktop supports linux in hyper v natively in windows if you dont want to use wsl 2

On Windows, Docker Desktop can use Hyper V to run a lightweight Linux VM where the Docker Engine runs. This is necessary because the Docker Engine relies on Linux kernel features (like namespaces and cgroups) that aren’t available on Windows directly.

So even though you’re running Docker Desktop on Windows, the containers are actually running inside that Linux VM.

ItzCrazyKns avatar Sep 19 '25 06:09 ItzCrazyKns