{"id":28383717,"url":"https://github.com/garearc/autodav","last_synced_at":"2026-05-18T19:38:05.136Z","repository":{"id":270174666,"uuid":"845287760","full_name":"GareArc/AutoDav","owner":"GareArc","description":"A streamlined Docker solution for setting up a WebDAV server with Nginx, featuring automatic SSL management via Certbot and an integrated web-based file browser for seamless file management.","archived":false,"fork":false,"pushed_at":"2024-12-31T19:52:43.000Z","size":236,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-25T14:47:15.989Z","etag":null,"topics":["certbot-ssl","cloud-storage","docker","filebrowser","nginx","self-hosted","webdav"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GareArc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-21T00:42:12.000Z","updated_at":"2025-02-21T23:04:51.000Z","dependencies_parsed_at":"2024-12-30T00:19:17.783Z","dependency_job_id":null,"html_url":"https://github.com/GareArc/AutoDav","commit_stats":null,"previous_names":["garearc/webdav-nginx-autossl","garearc/autodav"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GareArc/AutoDav","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareArc%2FAutoDav","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareArc%2FAutoDav/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareArc%2FAutoDav/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareArc%2FAutoDav/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GareArc","download_url":"https://codeload.github.com/GareArc/AutoDav/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareArc%2FAutoDav/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273046456,"owners_count":25036179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-31T02:00:09.071Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["certbot-ssl","cloud-storage","docker","filebrowser","nginx","self-hosted","webdav"],"created_at":"2025-05-30T07:10:19.584Z","updated_at":"2026-05-18T19:38:00.114Z","avatar_url":"https://github.com/GareArc.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AutoDav\n\n## Overview\n\n`AutoDav` helps you quickly set up a WebDAV service in Docker with automatic SSL support via Certbot. Additionally, it includes a web-based file browser UI (powered by [Filebrowser](https://filebrowser.org/)) for easy management of your WebDAV data.\n\n## Features\n\n- **WebDAV Service**: Securely store and access your files using WebDAV protocol.\n- **Automatic SSL**: Automate SSL certificate management with Certbot.\n- **File Browser UI**: Manage your files effortlessly via a user-friendly web interface.\n- **Customizable**: Configure all settings using a .env file.\n\n## Getting Started\n\nFollow these steps to set up and start your WebDAV service:\n\n1. Clone the Repository\n\n   ```bash\n   git clone https://github.com/GareArc/AutoDav.git\n   cd AutoDav\n   ```\n\n2. Configure Environment Variables\n\n    Copy the example .env file and customize it to fit your needs:\n\n   ```bash\n   cp .env.example .env\n   ```\n\n   Edit the .env file to configure WebDAV, Nginx, and Certbot settings:\n\n   | **Variable**                     | **Description**                                              | **Default/Example**                 |\n   | -------------------------------- | ------------------------------------------------------------ | ----------------------------------- |\n   | `WEBDAV_AUTH_TYPE`               | Authentication type.                                         | `Digest`                            |\n   | `WEBDAV_USERNAME`                | Username for WebDAV authentication.                          | `yourusername`                      |\n   | `WEBDAV_PASSWORD`                | Password for WebDAV authentication.                          | `yourpassword`                      |\n   | `NGINX_SSL_CERT_KEY_FILENAME`    | Filename of the SSL certificate private key.                 | `privkey.pem`                       |\n   | `NGINX_SSL_CERT_FILENAME`        | Filename of the SSL certificate.                             | `fullchain.pem`                     |\n   | `NGINX_KEEPALIVE_TIMEOUT`        | Timeout setting for Nginx keepalive connections. (0 for )    | `0`                                 |\n   | `NGINX_WEDAV_TIMEOUT`            | Timeout for communication between Nginx and client.          | `86400s`                            |\n   | `NGINX_HTTPS_ENABLED`            | Enable HTTPS for Nginx.                                      | `false`                             |\n   | `NGINX_ENABLE_CERTBOT_CHALLENGE` | Enable Certbot challenge for SSL certificate issuance.       | `false`                             |\n   | `EXPOSE_NGINX_SSL_PORT`          | Port to expose Nginx HTTPS (SSL) service.                    | `443`                               |\n   | `EXPOSE_NGINX_PORT`              | Port to expose Nginx HTTP service.                           | `80`                                |\n   | `CERTBOT_OPTIONS`                | Additional options for Certbot.                              | _(Optional, leave blank)_           |\n   | `CERTBOT_EMAIL`                  | Email address for Certbot notifications and registration.    | (Optional) `your-email@example.com` |\n   | `CERTBOT_DOMAIN`                 | Domain for which to issue the SSL certificate using Certbot. | `your-domain.com`                   |\n\n3. (Optional) Enable TLS/SSL\n\n    To enable HTTPS with TLS/SSL, configure Certbot by following the [Certbot Configuration Guide](./certbot/README.md). Ensure that you update the `.env` file with your certificate details and set `NGINX_HTTPS_ENABLED` to `true`.\n\n    You can also use existing certificate files directly by specifying their paths in the `.env` file. Refer to the environment variable settings in the table above for more details.\n\n4. Start the WebDAV Service\n\n    Launch the service using Docker Compose:\n\n    ```bash\n    docker compose up -d\n    ```\n\n    The service will start with the configurations defined in your `.env` file.\n\n## Accessing the File Browser\n\nOnce the service is running, you can access the file browser at:\n\n```shell\n# http\nhttp://{YOUR_SERVER_URL}/fb\n\n# with TLS/SSL\nhttps://{YOUR_SERVER_URL}/fb \n```\n\nFor example: `http://localhost/fb`.\n\n### Default Login Credentials\n\n- Username: `admin`\n- Password: `admin`\n\nIt is recommended to change these credentials immediately after your first login. You can update them in the settings page.\n    ![filebrowser_settings_1](./assets/filebrowser_setting_1.png)\n    ![filebrowser_settings_2](./assets/filebrowser_setting_2.png)\n\n### Notes\n\n- **WebDAV Authentication**: The WebDAV username and password are configured in the .env file and are different from the Filebrowser credentials.\n- **Certbot Setup**: Ensure you set up Certbot correctly if you plan to use HTTPS.\n- **Permission Issue**: If you encounter any permission issues, please ensure that all folders and files within `./volumes/webdav/data` are correctly owned by the user and group `82:82`.\n\n## Related Projects and Credits\n\nThis project builds upon and integrates several excellent tools and projects. Special thanks to the developers and maintainers of the following:\n\n- [bytemark/webdav](https://github.com/BytemarkHosting/docker-webdav): A Docker solution for WebDAV.\n- [Filebrowser](https://filebrowser.org/): A fantastic open-source file browser for managing files via a web UI.\n- Certbot: A tool that automates the process of setting up and managing TLS/SSL certificates.\n- Nginx: A powerful and flexible web server and reverse proxy.\n- Docker Compose: Simplifies multi-container Docker applications.\n\nThese projects made `AutoDav` possible. Explore and support these tools to enhance your development experience!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarearc%2Fautodav","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarearc%2Fautodav","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarearc%2Fautodav/lists"}