{"id":21684535,"url":"https://github.com/someaspy/nextcloud","last_synced_at":"2025-04-12T07:51:45.723Z","repository":{"id":213193648,"uuid":"733226754","full_name":"SomeAspy/NextCloud","owner":"SomeAspy","description":"NextCloud Config I use for my server","archived":false,"fork":false,"pushed_at":"2024-11-24T23:13:46.000Z","size":32,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T03:04:58.554Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"0bsd","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SomeAspy.png","metadata":{"files":{"readme":".github/readme.md","changelog":null,"contributing":null,"funding":".github/funding.yml","license":"license.txt","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},"funding":{"github":"someaspy"}},"created_at":"2023-12-18T21:11:47.000Z","updated_at":"2024-11-24T23:13:49.000Z","dependencies_parsed_at":"2024-11-25T00:27:28.312Z","dependency_job_id":null,"html_url":"https://github.com/SomeAspy/NextCloud","commit_stats":null,"previous_names":["someaspy/nextcloud"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SomeAspy%2FNextCloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SomeAspy%2FNextCloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SomeAspy%2FNextCloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SomeAspy%2FNextCloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SomeAspy","download_url":"https://codeload.github.com/SomeAspy/NextCloud/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248537005,"owners_count":21120690,"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","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":[],"created_at":"2024-11-25T16:15:59.068Z","updated_at":"2025-04-12T07:51:45.702Z","avatar_url":"https://github.com/SomeAspy.png","language":"Shell","funding_links":["https://github.com/sponsors/someaspy"],"categories":[],"sub_categories":[],"readme":"# EZ NextCloud\n\n\u003e NextCloud Config I use for my server\n\n## The Intent\n\n- Use NextCloud's fastest configs\n- Easy to use\n- Modular\n\n\u003e [!IMPORTANT]  \n\u003e Do not open issues without first reading the entirety of this readme, especially [the FAQ](#faq). You should also consider checking [the NextCloud docs](https://docs.nextcloud.com/server/latest/admin_manual/)\n\n## `example.env`\n\n\u003e This is an example file and it will not be read. You should copy it to `.env` and make applicable changes there.\n\n```env\n### YOU SHOULD CHANGE THE FOLLOWING CONFIGS ###\n\n# NextCloud Domains (The domains NextCloud will be accessed from as a space separated list.)\nNEXTCLOUD_TRUSTED_DOMAINS=localhost\n\n# Database Password\nPOSTGRES_PASSWORD=$0m3_R@nd0m_$+r1ng\n\n### CONFIGS BELOW THIS LINE WILL WORK BY DEFAULT ###\n\n# Volume locations\n\nDATA_VOLUME=./volumes/nextcloud/data\nCONFIG_VOLUME=./volumes/nextcloud/config\nTHEME_VOLUME=./volumes/nextcloud/themes\nAPP_VOLUME=./volumes/nextcloud/apps\nWEB_VOLUME=./volumes/nextcloud/web\n\n# Database\nPOSTGRES_DB=nextcloud\nPOSTGRES_USER=nextcloud\n\n# PHP\nPHP_MEMORY_LIMIT=4096M\n\n# Binding address\n# 0.0.0.0:80 will bind to all addresses on port 80 (HTTP)\n# 127.0.0.1:3030 will bind to localhost only, on port 3030 - useful for reverse proxies\nSERVE_PORT=0.0.0.0:80\n\n# Protocol (either HTTP, HTTPS or blank for autodetect)\n# Use 'HTTPS' if something else is handling HTTPS for instance (Like a reverse proxy)\nOVERWRITEPROTOCOL=\n\n# Proxy config (127.0.0.1/32 for localhost only, blank for autodetect)\nTRUSTED_PROXIES=\n\n# Environment docs: https://github.com/docker-library/docs/blob/master/nextcloud/README.md\n\n```\n\n## Post Install\n\nAfter the first run, you should do the following:\n\n- In `Administration\u003eBasic Settings` you should set `Background jobs` to run using `Cron (Recommended)`. This will ensure background tasks will run regardless of the frontend being used.\n- In `Administration\u003eOverview` you should review all error and warnings under `Security \u0026 setup warnings`. You can view how to fix some common ones in the [warnings FAQ](#i-have-warnings-in-the-admin-panel). The default install generally will have some issues.\n\n## Included Scripts\n\n- `execute.sh` - Runs commands inside the NextCloud image with proper permissions (Usage: `bash execute.sh occ`, `occ` being the command you want to run)\n- `fixIndexes.sh` - Fixes `The database is missing some indexes.`\n- `maintenanceOff.sh` - Disables maintenance mode. (This commonly auto-enables after updates)\n- `migrateMimeTypes.sh` - Fixes `One or more mimetype migrations are available.`\n- `shell.sh` - Access the docker container's shell\n- `update.sh` - Pull and build images\n\n## Adding to the base image\n\nThere are several reasons you may want to add to the base image. You can modify the base image by running extra commands using `config/dockerfile` with [standard dockerfile commands](https://docs.docker.com/engine/reference/builder/)\n\nIncluded in the git repo is a dockerfile that will override the standard image to include bz2. Without this, you will get a notice in the NextCloud overview:\n`This instance is missing some recommended PHP modules. For improved performance and better compatibility it is highly recommended to install them: bz2`\n\n## Notable Changes\n\n- Config files are only applied at container start. This is an optimization from the [NextCloud tuning guide.](https://docs.nextcloud.com/server/latest/admin_manual/installation/server_tuning.html#tune-php-fpm) (Specifically `opcache.revalidate_freq = 0` in [the `php.ini` file](../config/php.ini))\n\n- Instead of using Redis for caching, [Dragonfly](https://github.com/dragonflydb/dragonfly) is used.\n\n## FAQ\n\n\u003e [!NOTE]  \n\u003e Anything involving a change under `./volumes/*` will require the containers to have been run at least once, as the `volumes` folder is only generated on first run.\n\n### I want to use a different storage location\n\n\u003e [!CAUTION]\n\u003e This should be done BEFORE you run the container for the first time. Otherwise, NextCloud will be confused and try to reinstall.\n\n**Solution:** In [`docker-compose.yml`](../docker-compose.yml) under `app` and `volumes` replace `./volumes/nextcloud/data:/var/www/html/data` with `/path/to/data:/var/www/html/data`. ***The second part after the colon should always be the same***\n\n---\n\n### I get warnings from docker saying `x variable is not set.`\n\n**Solution:** Ensure you copied [`example.env`](../example.env) to `.env` in the head of the repository and looked over the config.\n\n---\n\n### I have warnings in the admin panel\n\nThere are a few warnings you will get with the default install using this configuration.\n\n#### The database is missing some indexes. Due to the fact that adding indexes on big tables could take some time they were not added automatically\n\n**Solution:** Run `bash scripts/fixIndexes.sh`\n\n#### One or more mimetype migrations are available\n\n**Solution:** Run `bash scripts/migrateMimeTypes.sh`\n\n#### Your installation has no default phone region set\n\n**Solution:** Add `'default_phone_region' =\u003e 'US',` to `volumes/nextcloud/config/config.php`. Replace `US` with your country's corresponding [ISO 3166-1 Alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1#Codes)\n\n#### You are accessing your instance over a secure connection, however your instance is generating insecure URLs\n\n**Solution:** Add `'overwriteprotocol' =\u003e 'https',` to `volumes/nextcloud/config/config.php`.\n\n#### Server has no maintenance window start time configured\n\n**Solution:** Add `'maintenance_window_start' =\u003e 1,` to `volumes/nextcloud/config/config.php`. Set this to a time that is best for you. [Documentation](https://docs.nextcloud.com/server/28/admin_manual/configuration_server/background_jobs_configuration.html)\n\n#### `X` error(s) in the logs since `Y`\n\n**Solution:** With a proper setup, this should resolve itself over time, and if it does not, you can check `Administration\u003eLogging`.\n\u003e [!IMPORTANT]  \n\u003e If something seems abnormal, make sure you read over the FAQ in it's entirety, as well as referring to [the NextCloud docs](https://docs.nextcloud.com/server/latest/admin_manual/). Consider opening an issue if you believe it is directly related to this config.\n\n#### You have not set or verified your email server configuration, yet\n\n**Solution:** Setup and send the test email ([NextCloud Email Documentation](https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/email_configuration.html))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomeaspy%2Fnextcloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsomeaspy%2Fnextcloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsomeaspy%2Fnextcloud/lists"}