diff --git a/packages/noco-docs/docs/010.index.md b/packages/noco-docs/docs/010.index.md index 0646a49589..3a793dbb9c 100644 --- a/packages/noco-docs/docs/010.index.md +++ b/packages/noco-docs/docs/010.index.md @@ -4,8 +4,6 @@ description: 'NocoDB Documentation' slug: / --- - - ![image](/img/banner.png) NocoDB is a no-code database platform that allows teams to collaborate and build applications with ease of a familiar and intuitive spreadsheet interface. This allows even non-developers or business users to become software creators. @@ -19,17 +17,17 @@ Also NocoDB's app store allows you to build business workflows on views with com ### Rich Spreadsheet Interface - ⚡  Basic Operations: Create, Read, Update and Delete on Tables, Columns, and Rows -- ⚡  Fields Operations: Sort, Filter, Hide / Unhide Columns +- ⚡  Fields Operations: Sort, Filter, Hide / Un-hide Columns - ⚡  Multiple Views Types: Grid (By default), Gallery, Form View and Kanban View - ⚡  View Permissions Types: Collaborative Views, & Locked Views - ⚡  Share Bases / Views: either Public or Private (with Password Protected) -- ⚡  Variant Cell Types: ID, LinkToAnotherRecord, Lookup, Rollup, SingleLineText, Attachement, Currency, Formula and etc +- ⚡  Variant Cell Types: ID, LinkToAnotherRecord, Lookup, Rollup, SingleLineText, Attachment, Currency, Formula and etc - ⚡  Access Control with Roles : Fine-grained Access Control at different levels - ⚡  and more ... ### App Store for Workflow Automations -We provide different integrations in three main categories. See App Store for details. +We provide different integrations in three main categories. See App Store for details. - ⚡  Chat : Slack, Discord, Mattermost, and etc - ⚡  Email : AWS SES, SMTP, MailerSend, and etc @@ -48,7 +46,7 @@ We allow you to sync schema changes if you have made changes outside NocoDB GUI. ### Audit -We are keeping all the user operation logs under one place. See Audit for details. +We are keeping all the user operation logs under one place. See Audit for details. ## Why are we building this? Most internet businesses equip themselves with either spreadsheet or a database to solve their business needs. Spreadsheets are used by a Billion+ humans collaboratively every single day. However, we are way off working at similar speeds on databases which are way more powerful tools when it comes to computing. Attempts to solve this with SaaS offerings has meant horrible access controls, vendor lockin, data lockin, abrupt price changes & most importantly a glass ceiling on what's possible in the future. diff --git a/packages/noco-docs/docs/020.getting-started/050.self-hosted/020.environment-variables.md b/packages/noco-docs/docs/020.getting-started/050.self-hosted/020.environment-variables.md index 3fa393f946..48ef7275d6 100644 --- a/packages/noco-docs/docs/020.getting-started/050.self-hosted/020.environment-variables.md +++ b/packages/noco-docs/docs/020.getting-started/050.self-hosted/020.environment-variables.md @@ -11,55 +11,55 @@ For production use-cases, it is **recommended** to configure - `NC_PUBLIC_URL`, - `NC_REDIS_URL` -| Variable | Comments | If absent | -|------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| -| NC_DB | See our example database URLs [here](https://github.com/nocodb/nocodb#docker). | A local SQLite will be created in root folder if `NC_DB` is not provided | -| NC_DB_JSON | Can be used instead of `NC_DB` and value should be valid knex connection JSON | | -| NC_DB_JSON_FILE | Can be used instead of `NC_DB` and value should be a valid path to knex connection JSON | | -| DATABASE_URL | JDBC URL Format. Can be used instead of NC_DB. | | -| DATABASE_URL_FILE | Can be used instead of DATABASE_URL: path to file containing JDBC URL Format. | | -| NC_AUTH_JWT_SECRET | JWT secret used for auth and storing other secrets | A random secret will be generated | -| PORT | For setting app running port | `8080` | -| DB_QUERY_LIMIT_DEFAULT | Default pagination limit | 25 | -| DB_QUERY_LIMIT_MAX | Maximum allowed pagination limit | 1000 | -| DB_QUERY_LIMIT_MIN | Minimum allowed pagination limit | 1 | -| NC_TOOL_DIR | App directory to keep metadata and app related files | Defaults to current working directory. In docker maps to `/usr/app/data/` for mounting volume. | -| NC_PUBLIC_URL | Used for sending Email invitations | Best guess from http request params | -| NC_JWT_EXPIRES_IN | JWT token expiry time | `10h` | -| NC_CONNECT_TO_EXTERNAL_DB_DISABLED | Disable Project creation with external database | | -| NC_INVITE_ONLY_SIGNUP | Removed since version 0.99.0 and now it's recommended to use [super admin settings menu](/setup-and-usages/account-settings#enable--disable-signup). Allow users to signup only via invite url, value should be any non-empty string. | | -| NUXT_PUBLIC_NC_BACKEND_URL | Custom Backend URL | ``http://localhost:8080`` will be used | -| NC_REQUEST_BODY_SIZE | Request body size [limit](https://expressjs.com/en/resources/middleware/body-parser.html#limit) | `1048576` | -| NC_EXPORT_MAX_TIMEOUT | After NC_EXPORT_MAX_TIMEOUT csv gets downloaded in batches | Default value 5000(in millisecond) will be used | -| NC_DISABLE_TELE | Disable telemetry | | -| NC_DASHBOARD_URL | Custom dashboard url path | `/dashboard` | -| NC_GOOGLE_CLIENT_ID | Google client id to enable google authentication | | -| NC_GOOGLE_CLIENT_SECRET | Google client secret to enable google authentication | | -| NC_MIGRATIONS_DISABLED | Disable NocoDB migration | | -| NC_MIN | If set to any non-empty string the default splash screen(initial welcome animation) and matrix screensaver will disable | | -| NC_SENTRY_DSN | For Sentry monitoring | | -| NC_REDIS_URL | Custom Redis URL. Example: `redis://:authpassword@127.0.0.1:6380/4` | Meta data will be stored in memory | -| NC_DISABLE_ERR_REPORT | Disable error reporting | | -| NC_DISABLE_CACHE | To be used only while debugging. On setting this to `true` - meta data be fetched from db instead of redis/cache. | `false` | -| AWS_ACCESS_KEY_ID | For Litestream - S3 access key id | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | -| AWS_SECRET_ACCESS_KEY | For Litestream - S3 secret access key | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | -| AWS_BUCKET | For Litestream - S3 bucket | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | -| AWS_BUCKET_PATH | For Litestream - S3 bucket path (like folder within S3 bucket) | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | -| NC_SMTP_FROM | For SMTP plugin - Email sender address | | -| NC_SMTP_HOST | For SMTP plugin - SMTP host value | | -| NC_SMTP_PORT | For SMTP plugin - SMTP port value | | -| NC_SMTP_USERNAME | For SMTP plugin (Optional) - SMTP username value for authentication | | -| NC_SMTP_PASSWORD | For SMTP plugin (Optional) - SMTP password value for authentication | | -| NC_SMTP_SECURE | For SMTP plugin (Optional) - To enable secure set value as `true` any other value treated as false | | -| NC_SMTP_IGNORE_TLS | For SMTP plugin (Optional) - To ignore tls set value as `true` any other value treated as false. For more info visit https://nodemailer.com/smtp/ | | -| NC_S3_BUCKET_NAME | For S3 storage plugin - AWS S3 bucket name | | -| NC_S3_REGION | For S3 storage plugin - AWS S3 region | | -| NC_S3_ACCESS_KEY | For S3 storage plugin - AWS access key credential for accessing resource | | -| NC_S3_ACCESS_SECRET | For S3 storage plugin - AWS access secret credential for accessing resource | | -| NC_ADMIN_EMAIL | For updating/creating super admin with provided email and password | | -| NC_ATTACHMENT_FIELD_SIZE | For setting the attachment field size(in Bytes) | Defaults to 20MB | -| NC_ADMIN_PASSWORD | For updating/creating super admin with provided email and password. Your password should have at least 8 letters with one uppercase, one number and one special letter(Allowed special chars $&+,:;=?@#\|'.^*()%!_-" ) | | -| NODE_OPTIONS | For passing Node.js [options](https://nodejs.org/api/cli.html#node_optionsoptions) to instance | | -| NC_MINIMAL_DBS | Create a new SQLite file for each project. All the db files are stored in `nc_minimal_dbs` folder in current working directory. (This option restricts project creation on external sources) | | -| NC_DISABLE_AUDIT | Disable Audit Log | `false` | -| NC_AUTOMATION_LOG_LEVEL | Possible Values: `OFF`, `ERROR`, `ALL`. See [Webhooks](/automation/webhook/create-webhook#call-log) for details. | `OFF` | \ No newline at end of file +| Variable | Comments | If absent | +|------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| +| NC_DB | See our example database URLs [here](https://github.com/nocodb/nocodb#docker). | A local SQLite will be created in root folder if `NC_DB` is not provided | +| NC_DB_JSON | Can be used instead of `NC_DB` and value should be valid knex connection JSON | | +| NC_DB_JSON_FILE | Can be used instead of `NC_DB` and value should be a valid path to knex connection JSON | | +| DATABASE_URL | JDBC URL Format. Can be used instead of NC_DB. | | +| DATABASE_URL_FILE | Can be used instead of DATABASE_URL: path to file containing JDBC URL Format. | | +| NC_AUTH_JWT_SECRET | JWT secret used for auth and storing other secrets | A random secret will be generated | +| PORT | For setting app running port | `8080` | +| DB_QUERY_LIMIT_DEFAULT | Default pagination limit | 25 | +| DB_QUERY_LIMIT_MAX | Maximum allowed pagination limit | 1000 | +| DB_QUERY_LIMIT_MIN | Minimum allowed pagination limit | 1 | +| NC_TOOL_DIR | App directory to keep metadata and app related files | Defaults to current working directory. In docker maps to `/usr/app/data/` for mounting volume. | +| NC_PUBLIC_URL | Used for sending Email invitations | Best guess from http request params | +| NC_JWT_EXPIRES_IN | JWT token expiry time | `10h` | +| NC_CONNECT_TO_EXTERNAL_DB_DISABLED | Disable Project creation with external database | | +| NC_INVITE_ONLY_SIGNUP | Removed since version 0.99.0 and now it's recommended to use [super admin settings menu](/account-settings/oss-specific-details#enable--disable-signup). Allow users to signup only via invite url, value should be any non-empty string. | | +| NUXT_PUBLIC_NC_BACKEND_URL | Custom Backend URL | ``http://localhost:8080`` will be used | +| NC_REQUEST_BODY_SIZE | Request body size [limit](https://expressjs.com/en/resources/middleware/body-parser.html#limit) | `1048576` | +| NC_EXPORT_MAX_TIMEOUT | After NC_EXPORT_MAX_TIMEOUT csv gets downloaded in batches | Default value 5000(in millisecond) will be used | +| NC_DISABLE_TELE | Disable telemetry | | +| NC_DASHBOARD_URL | Custom dashboard url path | `/dashboard` | +| NC_GOOGLE_CLIENT_ID | Google client id to enable google authentication | | +| NC_GOOGLE_CLIENT_SECRET | Google client secret to enable google authentication | | +| NC_MIGRATIONS_DISABLED | Disable NocoDB migration | | +| NC_MIN | If set to any non-empty string the default splash screen(initial welcome animation) and matrix screensaver will disable | | +| NC_SENTRY_DSN | For Sentry monitoring | | +| NC_REDIS_URL | Custom Redis URL. Example: `redis://:authpassword@127.0.0.1:6380/4` | Meta data will be stored in memory | +| NC_DISABLE_ERR_REPORT | Disable error reporting | | +| NC_DISABLE_CACHE | To be used only while debugging. On setting this to `true` - meta data be fetched from db instead of redis/cache. | `false` | +| AWS_ACCESS_KEY_ID | For Litestream - S3 access key id | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | +| AWS_SECRET_ACCESS_KEY | For Litestream - S3 secret access key | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | +| AWS_BUCKET | For Litestream - S3 bucket | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | +| AWS_BUCKET_PATH | For Litestream - S3 bucket path (like folder within S3 bucket) | If Litestream is configured and `NC_DB` is not present. SQLite gets backed up to S3 | +| NC_SMTP_FROM | For SMTP plugin - Email sender address | | +| NC_SMTP_HOST | For SMTP plugin - SMTP host value | | +| NC_SMTP_PORT | For SMTP plugin - SMTP port value | | +| NC_SMTP_USERNAME | For SMTP plugin (Optional) - SMTP username value for authentication | | +| NC_SMTP_PASSWORD | For SMTP plugin (Optional) - SMTP password value for authentication | | +| NC_SMTP_SECURE | For SMTP plugin (Optional) - To enable secure set value as `true` any other value treated as false | | +| NC_SMTP_IGNORE_TLS | For SMTP plugin (Optional) - To ignore tls set value as `true` any other value treated as false. For more info visit https://nodemailer.com/smtp/ | | +| NC_S3_BUCKET_NAME | For S3 storage plugin - AWS S3 bucket name | | +| NC_S3_REGION | For S3 storage plugin - AWS S3 region | | +| NC_S3_ACCESS_KEY | For S3 storage plugin - AWS access key credential for accessing resource | | +| NC_S3_ACCESS_SECRET | For S3 storage plugin - AWS access secret credential for accessing resource | | +| NC_ADMIN_EMAIL | For updating/creating super admin with provided email and password | | +| NC_ATTACHMENT_FIELD_SIZE | For setting the attachment field size(in Bytes) | Defaults to 20MB | +| NC_ADMIN_PASSWORD | For updating/creating super admin with provided email and password. Your password should have at least 8 letters with one uppercase, one number and one special letter(Allowed special chars $&+,:;=?@#\|'.^*()%!_-" ) | | +| NODE_OPTIONS | For passing Node.js [options](https://nodejs.org/api/cli.html#node_optionsoptions) to instance | | +| NC_MINIMAL_DBS | Create a new SQLite file for each project. All the db files are stored in `nc_minimal_dbs` folder in current working directory. (This option restricts project creation on external sources) | | +| NC_DISABLE_AUDIT | Disable Audit Log | `false` | +| NC_AUTOMATION_LOG_LEVEL | Possible Values: `OFF`, `ERROR`, `ALL`. See [Webhooks](/automation/webhook/create-webhook#call-log) for details. | `OFF` | \ No newline at end of file diff --git a/packages/noco-docs/docs/030.workspaces/010.workspace-overview.md b/packages/noco-docs/docs/030.workspaces/010.workspace-overview.md index 00d7a702f1..879ff6df80 100644 --- a/packages/noco-docs/docs/030.workspaces/010.workspace-overview.md +++ b/packages/noco-docs/docs/030.workspaces/010.workspace-overview.md @@ -18,7 +18,7 @@ NocoDB workspaces are a crucial feature for organizing and managing your data ef In summary, NocoDB workspaces streamline data management and member control, providing the flexibility and oversight necessary for various projects and teams. :::info -The self-hosted plan includes a default workspace, and it does not allow the creation of additional workspaces. +The Self-hosted plan includes a default workspace, and it does not allow the creation of additional workspaces. ::: ### Workspace context menu diff --git a/packages/noco-docs/docs/100.data-source/010.data-source-overview.md b/packages/noco-docs/docs/100.data-source/010.data-source-overview.md index 9f01825729..607e48a89e 100644 --- a/packages/noco-docs/docs/100.data-source/010.data-source-overview.md +++ b/packages/noco-docs/docs/100.data-source/010.data-source-overview.md @@ -11,6 +11,7 @@ NocoDB allows you to connect to external data sources and get a unified spreadsh 1. Connect/manage external data source 2. UI Access Control 3. Relations +4. Audit logs :::info Currently only one external data source can be added per project. @@ -53,6 +54,16 @@ After the sync is complete, you can see the updated state in the `Sync State` co ![ui acl](/img/v2/data-source/ui-acl.png) +## Audit logs + +1. Access Base context menu by clicking on the `Base` name in the left sidebar +2. Click on `Data Sources` tab +3. Click on `Audit` button listed under `Actions` column for the data source that you wish to access Audit logs for + +![audit](/img/v2/data-source/audit.png) +![audit logs](/img/v2/data-source/audit-logs.png) + + ## Relations 1. Access Base context menu by clicking on the `Base` name in the left sidebar diff --git a/packages/noco-docs/docs/120.collaboration/050.oss-specific-details.md b/packages/noco-docs/docs/120.collaboration/050.oss-specific-details.md new file mode 100644 index 0000000000..71b54217e9 --- /dev/null +++ b/packages/noco-docs/docs/120.collaboration/050.oss-specific-details.md @@ -0,0 +1,33 @@ +--- +title: 'On Self-Hosted plan' +description: 'This article explains specifics of User management on Self-Hosted plan.' +tags: ['Collaboration', 'Self-Hosted plan', 'User management'] +keywords: ['Collaboration', 'Self-Hosted plan', 'User management', 'User permissions', 'User roles'] +--- + +The Self-hosted plan includes a default workspace, and it does not allow the creation of additional workspaces. And hence, the user management on Self-Hosted plan is different from other plans. This article details the specifics of User management on Self-Hosted plan. + +## User Management +Self-hosted plan equivalent of a workspace is an organisation. An organisation can have multiple bases. Permissions within NocoDB are divided into two levels: `Organisation level` and `Base level`. + +### Organisation Level Permissions: +- `Org Level Creator`: Allows users to create new bases and access invited bases. +- `Org Level Viewer`: Allows users to access invited bases but does not permit the creation of new bases. + +![Screenshot 2023-08-22 at 5 01 41 PM](https://github.com/nocodb/nocodb/assets/86527202/adf3610d-505d-44a2-9460-c33d23e89c66) + +![Screenshot 2023-08-22 at 5 01 30 PM](https://github.com/nocodb/nocodb/assets/86527202/e32a5739-2b84-45c4-a1a2-d2823448eda7) + + +### Base Level Permissions: +The permissions at base level on self-hosted plans are similar to other plans. The base level permissions are summarized below: + +- `Owner`: The user who created the project. A project can have only one owner. The owner persists until the project exists and the role is non-transferable. The owner has access to carry out any operations within the project, including deleting it. +- `Creator`: Has access to carry out any operations within the project except deleting the project and removing the "Owner." +- `Editor`: Can modify data but cannot modify the schema (add/remove columns, tables, users, and such). +- `Commenter`: Can neither modify data nor schema, can only see data and can mark row-level comments. +- `Viewer`: Can only see data. + +Please note that the above-mentioned Base Level Permissions are additional to the already defined Organisation Level Permissions. + +In addition to the previously defined permissions, NocoDB also includes the role of `Super Admin`. The `Super Admin` is the first user to sign up on this NocoDB installation. An organisation can have only one `Super Admin` and this role is non-transferable. The `Super Admin` will have the equivalent permissions of an "Org Level Creator" and "Owner" for all projects within the organisation. diff --git a/packages/noco-docs/docs/140.account-settings/030.oss-specific-details.md b/packages/noco-docs/docs/140.account-settings/030.oss-specific-details.md new file mode 100644 index 0000000000..00ef39364e --- /dev/null +++ b/packages/noco-docs/docs/140.account-settings/030.oss-specific-details.md @@ -0,0 +1,27 @@ +--- +title: 'On Self-Hosted plan' +description: 'This article explains Account settings specifics on Self-Hosted plan.' +tags: ['Account settings', 'Self-Hosted plan'] +keywords: ['Account settings', 'Self-Hosted plan'] +--- + +Some of the Account settings features are available only on the Self-Hosted plan. This article explains the specifics of Account settings on Self-Hosted plan. + +## Enable / Disable Signup +Signup without an invitation is disabled by default and can be managed from UI by a super admin. + +![Invite only signup](/img/v2/account-settings/invite-only-sign-up.png) + + +## App Store + +App store lists available integrations for NocoDB. You can install and configure these integrations from the App store. + +![Screenshot 2023-08-22 at 5 02 26 PM](https://github.com/nocodb/nocodb/assets/86527202/e739a4b6-6ab6-4ee7-aac3-073d3aaf20ac) +We provide different integrations in three main categories. + +| Category | App Name | +|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| **Chat** | Microsoft Teams
Discord
Twilio
Whatsapp Twilio
Mattermost
Slack | +| **Email** | SMTP
MailerSend
AWS SES | +| **Storage** | AWS S3
Minio
Google Cloud Storage
Spaces
Backblaze B2
Vultr Object Storage
OvhCloud Object Storage
Linode Object Storage
UpCloud Object Storage
Scaleway Object Storage | diff --git a/packages/noco-docs/docusaurus.config.js b/packages/noco-docs/docusaurus.config.js index 8dd1e6e8cd..a1c8aca9a2 100644 --- a/packages/noco-docs/docusaurus.config.js +++ b/packages/noco-docs/docusaurus.config.js @@ -21,8 +21,8 @@ const config = { organizationName: "nocodb", // Usually your GitHub org/user name. projectName: "nocodb", // Usually your repo name. - onBrokenLinks: "warn", - onBrokenMarkdownLinks: "warn", + onBrokenLinks: "throw", + onBrokenMarkdownLinks: "throw", // Even if you don't use internalization, you can use this field to set useful // metadata like html lang. For example, if your site is Chinese, you may want @@ -122,7 +122,7 @@ const config = { darkTheme: darkCodeTheme, }, }), - clientModules: [require.resolve('./src/modules/tele.js')], + clientModules: [require.resolve("./src/modules/tele.js")], }; module.exports = config; diff --git a/packages/noco-docs/static/img/v2/account-settings/invite-only-sign-up.png b/packages/noco-docs/static/img/v2/account-settings/invite-only-sign-up.png new file mode 100644 index 0000000000..b81a8259fb Binary files /dev/null and b/packages/noco-docs/static/img/v2/account-settings/invite-only-sign-up.png differ diff --git a/packages/noco-docs/static/img/v2/data-source/audit-logs.png b/packages/noco-docs/static/img/v2/data-source/audit-logs.png new file mode 100644 index 0000000000..97b5bbf91e Binary files /dev/null and b/packages/noco-docs/static/img/v2/data-source/audit-logs.png differ diff --git a/packages/noco-docs/static/img/v2/data-source/audit.png b/packages/noco-docs/static/img/v2/data-source/audit.png new file mode 100644 index 0000000000..a919751fed Binary files /dev/null and b/packages/noco-docs/static/img/v2/data-source/audit.png differ