Support for Docker image Linkwarden

 

Application: https://linkwarden.app/

GitHub: https://github.com/linkwarden/linkwarden

Documentation: https://docs.linkwarden.app/

Template: https://github.com/UNRA1DUser/unraid-docker-templates

 

Overview:

|-------------------------------------------------
| General Information
|-------------------------------------------------
Linkwarden is a self-hosted, open-source collaborative bookmark manager to collect, organize and archive webpages.


The objective is to organize useful webpages and articles you find across the web in one place, and since useful webpages can go away (see the inevitability of Link Rot), Linkwarden also saves a copy of each webpage as a Screenshot and PDF, ensuring accessibility even if the original content is no longer available.


Additionally, Linkwarden is designed with collaboration in mind, sharing links with the public and/or allowing multiple users to work together seamlessly.


|-------------------------------------------------
| Register for an Account
|-------------------------------------------------
After the start of the Container you need to Sign up for an Account in your own Application. 


|-------------------------------------------------
| SSO/OAuth Integrations
|-------------------------------------------------
Here are all the SSO/OAuth integrations Linkwarden has -> https://docs.linkwarden.app/self-hosting/sso-oauth

 

Edited March 18, 20242 yr by UNRA1DUser

11 hours ago, UNRA1DUser said:

|-------------------------------------------------
| Register for an Account
|-------------------------------------------------
After the start of the Container you need to Sign up for an Account.

Why? Is this not fully contained and self hosted?

6 hours ago, JonathanM said:

Why? Is this not fully contained and self hosted?

 

It is completely self-hosted. But I have not found a single standard account in the DB. The documentation doesn't show anything either.

You can install an SSO connection and then log in with it. But without this, you first have to create an account within your own application.

I have also not read anything about an admin account that can administer all other accounts. If you find any information about it here, please let me know. I will then implement this. 

Hi,

 

I tried to install but it doesn't work, so maybe I missed a parameter or something (I changed nothing).

I noticed "WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap." at the end of the Docker command execution.

 

Do you have any advice or any guidance to make it works ? Many thanks

 

Ok I answer to myself:

 

First install "Postgres12.5" docker (define login, password, database name in the template -- example    zarkoff, strongpassword, linkwardenDB)

Also I used a "Custom Network" instead of "Bridge", --example ip is 192.168.1.80 (port 5432 if you do not change it)

 

Then install Linkwarden,

In Network type, put the same "Custom Network"

on line DATABASE_URL, put (if you consider all elements in example here)

postgresql://zarkoff:[email protected]:5432/linkwardenDB

 

And it works...

Edited April 1, 20242 yr by zarkoff

Hey there,

when logging out it redirects me to localhost:3000 instead of myip:3000.

I found a possible solution where I would need to edit the .env file. Thought it would be under appdata but the linkwarden folder is completly empty. So could you tell me where to find the .env?

On 4/5/2024 at 4:59 PM, Flex0 said:

Hey there,

when logging out it redirects me to localhost:3000 instead of myip:3000.

I found a possible solution where I would need to edit the .env file. Thought it would be under appdata but the linkwarden folder is completly empty. So could you tell me where to find the .env?

Hi,

 

you can just edit the "NEXTAUTH_URL" Value and point to you´re IP instead of localhost.

 

Example:

Change from "http://localhost:3000/api/v1/auth" to "http://192.168.1.1:3000/api/v1/auth"

good idea this container. I'll be able to keep a trace of the hundred of bookmarks i have.

I installed it with the compose plugin. 

On 4/1/2024 at 2:00 PM, zarkoff said:

Ok I answer to myself:

 

First install "Postgres12.5" docker (define login, password, database name in the template -- example    zarkoff, strongpassword, linkwardenDB)

Also I used a "Custom Network" instead of "Bridge", --example ip is 192.168.1.80 (port 5432 if you do not change it)

 

Then install Linkwarden,

In Network type, put the same "Custom Network"

on line DATABASE_URL, put (if you consider all elements in example here)

postgresql://zarkoff:[email protected]:5432/linkwardenDB

 

And it works...

 

 

I've been struggling with this. Followed all of this, triple checked all my details are correct and yet the Web UI isn't loading for me. Tried both "Custom: br0" and "Bridge" on Linkwarden's Network type field, both don't allow me to access the Web UI.

I'm having the same issue as other users here.. the IP isn't getting bound correctly. The port mapping section in the docker list is blank and the logs clearly show:

url: http://localhost:3000

even though I've changed the container IP and the NEXTAUTH_URL address.

Due to the mac-vlan issues on Unraid, I only use static IPs on containers, so unless the IP bindings can be fixed, I simply can't use this. Which is a shame.. I'd really like to migrate off Raindrop.

I got it working w/o any problem on Unraid. Maybe you can find some help in my configuration. 

 

First setup the Postgres DB, then configure Unraid Container with settings;

 

Network Type: Bridge
Console Shell Command: Shell
WebUI: 4344
NEXTAUTH_SECRET: (default)
NEXTAUTH_URL: http://192.168.1.20:4344/api/v1/auth
DATABASE_URL: postgresql://[pg_user]:[pg_pass]@192.168.1.20:5432/linkwarden
Data: (default)

 

Afterwards I configured Cloudflaretunnel, no problems. 

 

 

Edited August 19, 20241 yr by hennio

On 4/1/2024 at 3:00 PM, zarkoff said:

Ok I answer to myself:

 

First install "Postgres12.5" docker (define login, password, database name in the template -- example    zarkoff, strongpassword, linkwardenDB)

Also I used a "Custom Network" instead of "Bridge", --example ip is 192.168.1.80 (port 5432 if you do not change it)

 

Then install Linkwarden,

In Network type, put the same "Custom Network"

on line DATABASE_URL, put (if you consider all elements in example here)

postgresql://zarkoff:[email protected]:5432/linkwardenDB

 

And it works...

 

Thank you for this guide!!! I was about to follow and use "Postgres17" instead. Postgres12.5 wasn't working; after installing Postgres17, it finally brought up the WebUI.

I'm struggling with uploading all my Firefox bookmarks.

Currently I've exported it to HTML, but due to all the bookmarks, the HTML file is more than 50 Megabytes.
How do I upload this to my unRAID's Linkwarden container?

 

I use the latest version of this container, and it isn't forwarded to the internet.
So I am accessing it via 192.168.

 

I've already set NEXT_PUBLIC_MAX_FILE_SIZE to 1000, but that didn't help...

Thanks in advance!

If a second Database container is needed for this to function, it should be listed as an Additional Requirement.

Been messing with the settings for a while now, thinking that the Postgres DB was included in the image.

Great app!

when you try to create a user and the email is set up, it won't work.  You have to remove that information first and then your login will work.

Anyway, as odd as that is, afterward I am able to add my email variables and it seems to be ok.  But when testing the forgot password option, the email sent has a link that has 'undefined' for the domain and therefore doesn't resolve to anything to reset the password.  Any ideas on what I need to do to correct this?  I didnt see any variable I might need to add other than what I have already in there, including the admin variable:  

https://linkwarden.domain.com/api/v1/auth

 

The email it is sending to has a link to reset the password that looks like:

http://undefined/auth/reset-password?token=<string>

Any help would be appreciated.  Thanks.
 

Edited December 11, 20241 yr by danktankk

I installed Linkwarden about a week ago. Followed all and any instructions that I came across. Every 24-48 hours I realize that I am unable to access the WebUI and then notice that postgres12.5 had stopped and am unable to start it up again. I then proceed to remove postgresql12.5 and it's image. Also removed it from previous apps in CA and installed postgresql15 instead. I re-enter all pertinent information and I am good to go. This will run fine for another 1-2 days and then I run into the same issue. This happens regardless of what version of postgresql I choose. Obviously I now make sure to export my links because I know I will have to import them in a day or so.

 

Your time and assistance will be greatly appreciated. Peter

@peterbata When I ran linkwarden and postgresql17. My whole server crashed overnight due to out of memory I think. I have 256GB of RAM, I think there is something going on with linkwarden. I stopped both containers and I have not had that happen since. Seems similar to the Webui being unresponsiveness.

 

Did you ever find a solution?

Thanks so much for this container!

 

Would it be possible to update it? It's stuck at 2.1 whereas LW is up to 2.9...

 

Thanks again!

On 4/15/2025 at 8:10 AM, Krakout said:

Thanks so much for this container!

 

Would it be possible to update it? It's stuck at 2.1 whereas LW is up to 2.9...

 

Thanks again!

When installing modify the template registry from ghcr.io/linkwarden/linkwarden to ghcr.io/linkwarden/linkwarden:latest

 

That worked for me

19 hours ago, ffwd said:

When installing modify the template registry from ghcr.io/linkwarden/linkwarden to ghcr.io/linkwarden/linkwarden:latest

 

That worked for me

Oh fantastic, though I updated the repo look and the container... just disappeared. Great.

On 12/11/2024 at 9:14 AM, danktankk said:

Great app!

when you try to create a user and the email is set up, it won't work.  You have to remove that information first and then your login will work.

Anyway, as odd as that is, afterward I am able to add my email variables and it seems to be ok.  But when testing the forgot password option, the email sent has a link that has 'undefined' for the domain and therefore doesn't resolve to anything to reset the password.  Any ideas on what I need to do to correct this?  I didnt see any variable I might need to add other than what I have already in there, including the admin variable:  

https://linkwarden.domain.com/api/v1/auth

 

The email it is sending to has a link to reset the password that looks like:

http://undefined/auth/reset-password?token=<string>

Any help would be appreciated.  Thanks.
 

This took me a minute to figure out as it's not documented, yet. You've got to pass a new environment variable in your SMTP section: "BASE_URL."

BASE_URL=linkwarden.your.domain

Note, the protocol (http, https) is not necessary here. Hope this helps!

So, I forgot my password (damn...) and there's no option to retrieve/change it. Any ideas as to how to proceed? I do have an authentication key, I am logged in on one browser tab, but there's no option to change the password? 

 

Any ideas would be welcome!

 

 

Any idea how to get tailscale working with this container? The entire app crashes out with no log accessibility when I enable the tailscale funnel. Thanks

Ended up using TSDProxy. Worked perfectly

Hi! Thanks for setting up the Unraid template, but...

Is there a reason why your template (and other, like postgresql alpine) use /mnt/cache/appdata instead of /mnt/user/appdata?

This goes against my current knowledge of Unraid, that everything should be pointing to locations inside /mnt/user.

It caused my appdata for them to go missing on reboot / mover, since I use a zfs pool for appdata and have no standard cache. Thankfully no important data loss.

Edited September 23, 2025Sep 23 by Eksitus