Total beginner here trying to install Cozy. I have a couple of questions.


Hi! I have tried to install cozy-stack on Debian in a VM and I think I kinda got it right. I can access domains like over HTTPS, and on those sites are an Nginx welcome screen. (?)

How do I install the actual applications on these subdomains? I don’t really understand how this works.

Also i can not reach the base domain. Is there supposed to be anything there?

Thanks and any help is appreciated!


Hi and welcome on Cozy !
Did you use cozy-coclyco ? Or install it by hand ?

Have you followed this documentation :


Yes i followed that tutorial!

I had some issues in the " ACME (Let’s Encrypt)" step but i run nginxproxymanager on my server so i got an SSL certificate from there.

I ran the “Create instances” and it seemed like it installed. I tried add-instance like photos and drive but they seem to already be installed.


Oh, so you got certificates without the use of cozy-coclyco ?

the command :

cozy-coclyco create

provides SSL certificate generation as well as instance creation + deployment (home.cozy, photos.cozy, etc.).

What does this command return for you ?


Aha, i see, so maybe, because it failed for me, it didn’t continue the installation?
Did it again and edited the nginx file.
I get this error:

requests.exceptions.HTTPError: 404 Client Error: Not Found for url:


@cpique I posted an answer above


I guess you have an issue with your nginx configuration.

Dont hesitate to post your Nginx config file

Maybe @Aeris and @Clochix will be able to help you


Took it straight from the instructions:

server {
listen 80 default_server;
listen [::]:80 default_server;

root /var/www/html;
server_name _;

location /.well-known/acme-challenge/ {
    alias /etc/ssl/private/acme-challenge/;

location / {
    return 301 https://$host$request_uri;



Are you sure your DNS is correct and point to the right IP and on the right nginx?
You can’t have another nginx in front of the provided one by cozy with our standard setup.


@aeris don’t know. I followed the exact steps exactly as stated. How could i check that? Thank you


Steps we provide are only one related to Cozy software.
You have to set up correctly all others requirements, like buying a domain name, configuring your DNS to point it to your Cozy device, opening your firewall, configuring your modem NAT to forward traffic to your future Cozy device, etc.
Those points are too generic and depend of too much parameters that we can’t provide support to do that. Each of them must be addressed by the related provider (registrar, DNS provider, ISP…).


@aeris So I have all the domains set up with my provider:

I have forwarded the ports 80/443 to the IP of the Debian VM. (also should not be a problem).


These are the steps i did:

What am i missing?


Don’t know, but here Let’s Encrypt is not able to join the nginx you set up.
And this is not really related to Cozy, but more to DNS or NAT or wrong nginx end point or…


If you have multiple others domains, be sure to not have any other reverse proxy in front of your Cozy nginx.
We don’t officially support configuration without a Cozy nginx directly available on the Internet.


These are not in the same Debian VM, they are on my unRAID server. The IPs are different and they have different port forwarding rules.

What do you mean with “in front of” ?


You need to have your Cozy nginx directly available on the Internet, with no other reverse proxy in front of it.
Generally speaking, you need reverse proxying if you host multiple services on the same IP(v4) address.


Have you tried this step :

  • You can regenerate the nginx vhost with
cozy-coclyco vhost <fqdn>


Because LE seems not able to issue a certificate, vhost command will break the nginx because certificate not available and so nginx will refuse to start or reload…


I did everything over again and for some reason, I got this instead:

requests.exceptions.ConnectionError: HTTPConnectionPool(host='', port=80): Max 
retries exceeded with url: /.well-known/acme-challenge/- 
aMtlH6SMuuGDQ7dWht8M07yNMXYJlATj9DWV0L8Eqo (Caused by 
NewConnectionError('<requests.packages.urllib3.connection.HTTPConnection object at 0x7f7686279470>: 
Failed to establish a new connection: [Errno -2] Name or service not known',))