{"id":16037851,"url":"https://github.com/joseluisq/docker-cubesql","last_synced_at":"2026-05-12T07:42:22.973Z","repository":{"id":45747438,"uuid":"161335481","full_name":"joseluisq/docker-cubesql","owner":"joseluisq","description":"A Linux Docker image for the CubeSQL server.","archived":false,"fork":false,"pushed_at":"2022-07-15T17:41:53.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-05-22T23:06:20.261Z","etag":null,"topics":["cubesql","cubesql-server","debian-11","debian-bullseye","docker","docker-image","linux"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joseluisq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-12-11T13:08:50.000Z","updated_at":"2022-03-14T09:24:48.000Z","dependencies_parsed_at":"2022-08-05T06:15:34.507Z","dependency_job_id":null,"html_url":"https://github.com/joseluisq/docker-cubesql","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseluisq%2Fdocker-cubesql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseluisq%2Fdocker-cubesql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseluisq%2Fdocker-cubesql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joseluisq%2Fdocker-cubesql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joseluisq","download_url":"https://codeload.github.com/joseluisq/docker-cubesql/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294463,"owners_count":20915338,"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":["cubesql","cubesql-server","debian-11","debian-bullseye","docker","docker-image","linux"],"created_at":"2024-10-08T22:21:49.411Z","updated_at":"2026-05-12T07:42:22.968Z","avatar_url":"https://github.com/joseluisq.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker cubeSQL [![devel](https://github.com/joseluisq/docker-cubesql/workflows/devel/badge.svg)](https://github.com/joseluisq/docker-cubesql/actions?query=workflow%3Adevel) ![Docker Image Version (tag latest semver)](https://img.shields.io/docker/v/joseluisq/cubesql/latest) [![Docker Image Size (tag)](https://img.shields.io/docker/image-size/joseluisq/cubesql/latest)](https://hub.docker.com/r/joseluisq/cubesql/tags) [![Docker Image](https://img.shields.io/docker/pulls/joseluisq/cubesql.svg)](https://hub.docker.com/r/joseluisq/cubesql/)\n\n\u003e A Linux [Docker](https://www.docker.com/) image for the [cubeSQL](https://www.sqlabs.com/cubesql) server. \u003cbr\u003e\n\u003e _\u003csmall\u003e**Note:** This is not an official Docker image.\u003csmall\u003e_\n\nIt provides the [cubeSQL](https://www.sqlabs.com/cubesql) server using latest __Debian [12-slim](https://hub.docker.com/_/debian/tags?name=12-slim)__ ([Bookworm](https://www.debian.org/News/2025/20250315)).\n\n## cubeSQL License/Registration\n\nYou will need to register cubeSQL server.\n\n1. [Request a key](https://www.sqlabs.com/cubesql_devkey) from sqlabs website.\n2. Download [cubeSQL Admin](https://github.com/cubesql/cubeSQLAdmin), connect to cubeSQL and register your server.\n\n*Note: The default server port is `4430`*\n\n## Usage\n\nRun a container\n\n```sh\ndocker run --rm -it joseluisq/cubesql:latest\n```\n\nOr run the server using [Docker Compose](https://docs.docker.com/compose/)\n\n```sh\ndocker-compose -f docker-compose.sample.yml up\n# [+] Running 1/1\n# Container docker-cubesql_cubesql-server_1  Recreated\n# Attaching to cubesql-server_1\n# cubesql-server_1  | CubeSQL Server version 5.8.0 64bit mode, Build Date Sep 26 2020 (SQLite Engine 3.33.0), TSL Library is LibreSSL 3.1.4\n# cubesql-server_1  |\n```\n\nOr extend this image using your own `Dockerfile`\n\n```Dockerfile\nFROM joseluisq/cubesql:latest\n# ....\n```\n\n## Environment variables\n\nThe image provides the following environment variables for setup with the following default values.\n\n- `CUBESQL_PORT`: `4430`\n- `CUBESQL_DATA`: `/data`\n- `CUBESQL_SETTINGS`: `/data/cubesql.settings`\n- `CUBESQL_SSL_ONLY`: `false`\n- `CUBESQL_SSL_CERTIFICATE`:\n- `CUBESQL_CA_ROOT_CERTIFICATE`:\n- `CUBESQL_MAX_SHARED_DATABASES`:\n- `CUBESQL_DEBUG_MODE`: `NONE`\n- `CUBESQL_LOG_FORMAT`: `CONSOLE`\n- `CUBESQL_LOG_VERBOSITY`: `NONE`\n- `CUBESQL_OPTS`:\n\n`CUBESQL_OPTS` is a custom env to pass extra arguments to `cubesql` server which are not listed above.\n\nYou can see the all cubeSQL options typing:\n\n```sh\ndocker run --rm -it joseluisq/cubesql:latest cubesql -h\n# usage: cubesql [options]\n# Available options are:\n#   -h                      print usage and exit\n#   -y                      print version and exit\n#   -z                      do not load disabled logins table\n#   -q                      enable SSL only connections mode\n#   -P                      force optional verify peer even if root CA certificate is loaded\n#   -t nthreads             set default startup working threads\n#   -o ndatabases           set max number of shared databases\n#   -l backlog              backlog size to be specified in the listen function\n#   -p server_port          server port\n#   -i ip_address           ip address used to bind\n#   -f log_format           log format, values can be TEXT, SQLITE and CONSOLE\n#   -v log_verbosity        log verbosity, values can be NONE, SQL_ERRORS or SQL_COMMANDS\n#   -g debug_mode           debug mode, values can be NONE, FILE, CONSOLE, SYSTEM\n#   -d db_path              full path to databases folder\n#   -r restore_path         full path to restore folder\n#   -b backup_path          full path to backup folder\n#   -n manual_backup_path   full path to manual backup folder\n#   -w ssl_crypto_path      full path to ssl and crypto libraries (in the form \"ssl_libpath|crypto_libpath\")\n#   -u upload_path          full path to upload folder\n#   -s settings_file        full path to settings file\n#   -c config_file          full path to JSON startup config file\n#   -e log_file             full path to log file\n#   -x data_path            full path to the main data folder used by the server\n#   -m ssl_certificate      full path to the SSL cerfificate file\n#   -M ssl_certificate_key  full path to the SSL cerfificate key file\n#   -a ca_root_certificate  full path to the SSL CA root certiticate to enable client peer verification\n```\n\n## Enable SSL only connections mode\n\nFirst set up the cubesql server using `CUBESQL_SSL_ONLY=true` environment variable in order to accept **only** SSL connections.\n\nThen on client side, for example [cubeSQL Admin](https://github.com/cubesql/cubeSQLAdmin) to connect to the server make sure to use encryption SSL.\n\n![image](https://user-images.githubusercontent.com/1700322/147923364-549c7097-b240-4527-bff5-bbb165a8496f.png)\n\nFor more details take a look at [How to create a SSL certificate for localhost](https://www.sqlabs.com/blog/2020/09/how-to-create-a-ssl-certificate-for-localhost/)\n\n## Docker Compose Example\n\nA working [Docker Compose](https://docs.docker.com/compose/) example can be found on [docker-compose.sample.yml](docker-compose.sample.yml)\n\n## Contributions\n\nUnless you explicitly state otherwise, any contribution intentionally submitted for inclusion in current work by you, as defined in the Apache-2.0 license, shall be dual licensed as described below, without any additional terms or conditions.\n\nFeel free to send some [Pull request](https://github.com/joseluisq/docker-cubesql/pulls) or file an [issue](https://github.com/joseluisq/docker-cubesql/issues).\n\n## License\n\nThis work is primarily distributed under the terms of both the [MIT license](LICENSE-MIT) and the [Apache License (Version 2.0)](LICENSE-APACHE).\n\n© 2021-present [Jose Quintana](https://joseluisq.net)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoseluisq%2Fdocker-cubesql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoseluisq%2Fdocker-cubesql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoseluisq%2Fdocker-cubesql/lists"}