docs improvements

phartenfeller · phartenfeller · commit 76a2c0fb189d · 2026-01-08T11:31:16.000+01:00
diff --git a/docs/src/content/docs/getting-started/backups.mdx b/docs/src/content/docs/getting-started/backups.mdx
@@ -12,7 +12,7 @@ import { Aside } from "@astrojs/starlight/components";
 Create datapump dumps of all users, including APEX workspaces and applications:
 
 ```bash
-local-23ai.sh backup-all
+local-26ai.sh backup-all
 ```
 
 Files are written to the `./backups/export` directory.
@@ -22,15 +22,15 @@ Files are written to the `./backups/export` directory.
 Backup a single schema with its workspace and applications:
 
 ```bash
-local-23ai.sh backup-schema movies
+local-26ai.sh backup-schema movies
 ```
 
 ### Import Backup
 
 Restore a previously created backup:
 
 ```bash
-local-23ai.sh import-backup movies
+local-26ai.sh import-backup movies
 ```
 
 <Aside type="note" title="Future Enhancements">
diff --git a/docs/src/content/docs/getting-started/common-tasks.mdx b/docs/src/content/docs/getting-started/common-tasks.mdx
@@ -86,6 +86,53 @@ For development environments, you might want to disable archive logging. You wil
 ./scripts/disable-archive-logs.sh
 ```
 
+### Manage APEX Account Expiration
+
+#### Unexpire Accounts
+
+If APEX_PUBLIC_USER or workspace accounts are locked due to password expiration, unlock them with:
+
+```bash
+./scripts/unexpire-accounts.sh
+```
+
+This is useful after database migrations or when accounts have expired due to time constraints.
+
+#### Disable Password Expiration
+
+To prevent APEX workspace accounts from expiring in the future:
+
+```bash
+./scripts/disable-password-expiration.sh
+```
+
+<Aside type="note">
+  Even with password expiration disabled, users may still be prompted to change
+  their password on their first login after a migration.
+</Aside>
+
+## Workspace Import/Export
+
+### Import All Exports
+
+Automatically import all export files from the `./backups/import/` directory:
+
+```bash
+./scripts/import-all.sh
+```
+
+This is particularly useful during database migrations when you need to bulk import multiple workspaces and schemas. The script will provide a summary of successful and failed imports.
+
+### Fix Workspace Export Issues
+
+When re-importing APEX workspaces, you may encounter issues due to a [known bug with group assignments](https://forums.oracle.com/ords/apexds/post/apex-18-2-failing-to-import-workspace-5048). Fix this automatically:
+
+```bash
+./scripts/fix-ws-group-ids.sh
+```
+
+This script updates all export files in `./backups/import/` to remove problematic group ID parameters, allowing successful re-import.
+
 ## Complete Environment Reset
 
 ### Delete All Data
diff --git a/docs/src/content/docs/getting-started/creating-users.mdx b/docs/src/content/docs/getting-started/creating-users.mdx
@@ -48,6 +48,12 @@ local-26ai.sh clear-schema movies
 # Asks for confirmation before proceeding
 ```
 
+To skip the confirmation prompt (useful for automation), use the `-y` flag:
+
+```bash
+local-26ai.sh clear-schema movies -y
+```
+
 <Aside type="caution" title="Data Loss Warning">
   This drops ALL objects in the schema. Never run this accidentally on important
   schemas! Or better: run backups regularly.
@@ -69,10 +75,10 @@ All created users are automatically stored in SQLcl's connection store:
 
 ```bash
 # Connect using the stored connection
-sql -name local-23ai-movies
+sql -name local-26ai-movies
 
 # Connect to sys user
-sql -name local-23ai-sys
+sql -name local-26ai-sys
 ```
 
 You will also find the connections in the VS Code SQL Developer extension. You might need to refresh the connections list after creating a new user.
@@ -81,7 +87,7 @@ You will also find the connections in the VS Code SQL Developer extension. You m
 
 Use these connection details for other development tools:
 
-- **Host**: 23ai
+- **Host**: 26ai
 - **Port**: 1521
 - **Service**: FREEPDB1
 - **Username**: Your schema name
diff --git a/docs/src/content/docs/getting-started/index.mdx b/docs/src/content/docs/getting-started/index.mdx
@@ -7,7 +7,7 @@ sidebar:
 
 import { Aside } from "@astrojs/starlight/components";
 
-Get your Oracle 23ai database with APEX and ORDS running locally in just a few minutes. This guide will walk you through the complete setup process.
+Get your Oracle 26ai database with APEX and ORDS running locally in just a few minutes. This guide will walk you through the complete setup process.
 
 ## Prerequisites
 
@@ -122,6 +122,12 @@ If you get an error messsage saying "Account Is Locked" run the following:
 
 You can now reload the APEX page at http://localhost:8181/ords/apex and should see no more error messages.
 
+If you don't want APEX to force you to change passwords, you can also run the disable password expiration script:
+
+```sh
+./scripts/disable-password-expiration.sh
+```
+
 ### 7. PATH Configuration
 
 For easier script access, add the repository to your PATH:
diff --git a/docs/src/content/docs/getting-started/install-apps-scripts.mdx b/docs/src/content/docs/getting-started/install-apps-scripts.mdx
@@ -25,9 +25,17 @@ This will:
   - List of invalid objects
   - APEX object dependency scan results
 
+### Skip Confirmation
+
+To skip the confirmation prompt (useful for automation), use the `-y` flag:
+
+```bash
+local-26ai.sh test-app-install ./path/to/my_app.sql -y
+```
+
 ## Test SQL Scripts
 
-Test application installations in a clean environment:
+Test SQL scripts in a clean environment:
 
 ```bash
 local-26ai.sh test-script-install ./path/to/sql_script.sql
@@ -40,3 +48,11 @@ This will:
 - Provide a summary with:
   - Object types and counts
   - List of invalid objects
+
+### Skip Confirmation
+
+To skip the confirmation prompt (useful for automation), use the `-y` flag:
+
+```bash
+local-26ai.sh test-script-install ./path/to/sql_script.sql -y
+```
diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx
@@ -1,11 +1,11 @@
 ---
-title: Introduction
-description: Containerized APEX development environment - Have a 26ai with APEX and ORDS running in minutes
+title: Oracle APEX Local Development Environment - Containerized Setup
+description: Containerized Oracle APEX development environment with 26ai database and ORDS. Works with Docker, Podman, or any container runtime. Set up local APEX development in minutes with automated workspace management, backups, and testing tools.
 sidebar:
   order: 10
 template: doc
 hero:
-  tagline: Have a 26ai with APEX and ORDS running in a few minutes. A containerized development environment that makes Oracle APEX development on your local machine as easy as possible.
+  tagline: Set up Oracle APEX local development in minutes. A containerized environment that makes building and testing APEX applications on your machine effortless.
   actions:
     - text: Get Started
       link: /products/uc-local-apex-dev/docs/getting-started/
@@ -16,55 +16,108 @@ hero:
       variant: minimal
 ---
 
-uc-local-apex-dev is a ready-to-use containerized development environment that automates common Oracle APEX development tasks. Get a complete Oracle 26ai database with APEX and ORDS running locally with optimal settings and convenient bash scripts for common operations.
+uc-local-apex-dev is a containerized Oracle APEX development environment that **automates the tedious parts** of administering a local environment. Works with Docker, Podman, or any container runtime. Get a complete Oracle 26ai database with APEX and ORDS (with SSL) running on your machine, plus convenient bash scripts that handle workspace creation, backups, schema clearing, and script/APEX application testing with a single command.
 
 ## Key Features
 
 import { Card, CardGrid } from "@astrojs/starlight/components";
 
 <CardGrid>
   <Card title="Quick Setup" icon="rocket">
-    Get Oracle 26ai with APEX and ORDS running in just a few minutes with
-    automated setup scripts.
+    Get Oracle 26ai with APEX 24.2+ and ORDS running in minutes using any
+    container runtime (Docker, Podman, etc.) with automated setup scripts.
   </Card>
   <Card title="Oracle 26ai" icon="seti:db">
-    Run the latest Oracle Database 26ai with all features enabled.
+    Run the latest Oracle Database 26ai Free with all features enabled and
+    pre-configured for development.
   </Card>
-  <Card title="User & Workspace Management" icon="add-document">
-    Create users and workspaces with optimal settings using a single command.
-    All users are stored in SQLcl and VS Code for easy access.
+  <Card title="One-Command Operations" icon="laptop">
+    Simple wrapper script (local-26ai.sh) turns complex tasks into single
+    commands: create users, backup workspaces, clear schemas, test installs.
+  </Card>
+  <Card title="Automated User Management" icon="add-document">
+    Create users and workspaces with optimal development grants using a single
+    command. Users are automatically registered in SQLcl and VS Code for instant
+    access.
   </Card>
   <Card title="Backup & Restore" icon="cloud-download">
-    Easily backup and restore your data, workspaces, and applications with
-    built-in datapump integration.
+    Built-in Oracle DataPump integration for easy backup and restore of schemas,
+    workspaces, and applications with a single command.
+  </Card>
+  <Card title="Installation Testing" icon="approve-check">
+    Test APEX application installs and SQL scripts repeatedly in isolated test
+    users. Automatically validates dependencies and installation success.
   </Card>
-  <Card title="Development Tools" icon="seti:config">
-    Built-in support for SQLcl, VS Code SQL Developer, and PL/SQL debugging.
+  <Card title="HTTPS/SSL Ready" icon="approve-check-circle">
+    ORDS runs with SSL support using self-signed certificates for secure local
+    development matching production environments.
   </Card>
-  <Card title="Testing Environment" icon="approve-check">
-    Test APEX application installs and install scripts with automated validation
-    and dependency scanning.
+  <Card title="PL/SQL Debugging" icon="seti:config">
+    Pre-configured with all necessary grants and settings for VS Code SQL
+    Developer debugger and SQLcl development.
   </Card>
 </CardGrid>
 
-## Perfect for APEX Developers
+## Perfect for Local APEX Development
 
-This environment is specifically designed for Oracle APEX developers who want to:
+This containerized environment is specifically designed for Oracle APEX developers who need a local development database and want to:
 
-- **Develop Locally**: Work on APEX applications without needing a remote database
-- **Test Repeatedly**: Clear schemas and test installation scripts multiple times
-- **Debug Efficiently**: Use VS Code SQL Developer debugger with proper grants
-- **Manage Workspaces**: Create and manage multiple development workspaces easily
-- **Backup Regularly**: Protect your work with automated backup solutions
+- **Develop Locally**: Work on APEX applications without needing a remote database, cloud instance, or apex.oracle.com
+- **Test Installation Scripts**: Clear schemas and test APEX application installs multiple times with zero hassle
+- **Rapid Prototyping**: Spin up new workspaces and test schemas instantly for experimenting with ideas
+- **Debug PL/SQL Code**: Use VS Code SQL Developer debugger with all proper grants pre-configured
+- **Manage Workspaces**: Create and manage multiple APEX workspaces and database schemas with ease
+- **SSL**: Run ORDS with SSL locally to match production environments or to not run into protocol missatch errors
+- **Automated Backups**: A single script to export all your schemas, APEX workspaces, and applications, plus ORDS modules
+- **Safe Testing Environment**: Experiment with new APEX features without risk to production or shared development databases
 
 ## What's Included
 
-- **Oracle Database 26ai**: Latest Oracle database with all features
-- **Oracle APEX 24.2+**: Full APEX installation with admin access
-- **Oracle ORDS**: REST Data Services for APEX connectivity
-- **Automated Scripts**: Bash scripts for common development tasks
-- **Development Grants**: All necessary permissions for debugging and development
+- **Oracle Database 26ai Free**: Latest Oracle database with all development features
+- **Latest Oracle APEX**: Full APEX installation with admin access
+- **Oracle ORDS with SSL**: REST Data Services pre-configured with self-signed certificates
+- **Automated Scripts**: 20+ bash scripts for common development tasks via simple wrapper
+- **Development Grants**: All necessary permissions for debugging, DataPump, and workspace management
+- **SQLcl Integration**: All created users automatically registered for instant connections
+- **VS Code Integration**: All created users available in VS Code SQL Developer extension and PL/SQL debugging support
 
 ## Important Note
 
-⚠️ **This is not for production use!** The environment is configured to be unsecure to make development as easy as possible. Use at your own risk and run backups regularly.
+⚠️ **This is not for production use!** The environment is intentionally configured to be unsecure and optimized for ease of development. Passwords are stored in plain text, all security features are relaxed, and the focus is on speed and convenience over security. Use at your own risk and run backups regularly.
+
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "SoftwareApplication",
+  "name": "uc-local-apex-dev",
+  "applicationCategory": "DeveloperApplication",
+  "operatingSystem": "Linux, macOS, Windows",
+  "description": "Containerized Oracle APEX development environment with 26ai database and ORDS. Set up local APEX development in minutes with automated workspace management, backups, and testing tools.",
+  "offers": {
+    "@type": "Offer",
+    "price": "0",
+    "priceCurrency": "USD"
+  },
+  "author": {
+    "@type": "Organization",
+    "name": "United Codes",
+    "url": "https://www.united-codes.com"
+  },
+  "url": "https://www.united-codes.com/products/uc-local-apex-dev/docs/",
+  "downloadUrl": "https://github.com/United-Codes/uc-local-apex-dev",
+  "codeRepository": "https://github.com/United-Codes/uc-local-apex-dev",
+  "programmingLanguage": ["Shell", "SQL", "PL/SQL"],
+  "softwareRequirements": "Docker or Podman, docker-compose, SQLcl, Bash-compatible shell",
+  "featureList": [
+    "Quick setup with Oracle 26ai database",
+    "Oracle APEX 24.2+ with admin access",
+    "Oracle ORDS with SSL support",
+    "Automated user and workspace creation",
+    "Built-in DataPump backup and restore",
+    "PL/SQL debugging support",
+    "Installation testing for APEX applications",
+    "SQLcl and VS Code integration"
+  ],
+  "keywords": "Oracle APEX, Oracle Database, ORDS, local development, containerized, Docker, Podman, PL/SQL, workspace management, backup, DataPump"
+}
+</script>
diff --git a/docs/src/content/docs/migrations/26-1.md b/docs/src/content/docs/migrations/26-1.md
@@ -15,10 +15,19 @@ If you haven't installed uc-local-apex-dev yet, you can find the [setup instruct
   - Data files are not compatible, so a dump/restore is needed
 - ORDS 25.2 → ORDS 25.4
 - This now a space optimized way with own tablespace for audit and APEX data from [Connor McDonald's blog post](https://connor-mcdonald.com/2023/12/18/the-ultimate-database-free-edition/).
-- Scripts
-  - `test-script-install` to test SQL scripts in a clean environment ([more on test-script-install](/products/uc-local-apex-dev/docs/getting-started/install-apps-scripts/#test-sql-scripts))
-  - `used-space` to check the used space of the database ([more on used-space](/products/uc-local-apex-dev/docs/getting-started/common-tasks/#check-database-space-usage))
-  - `shrink-space` to reclaim space from tablespaces ([more on shrink-space](/products/uc-local-apex-dev/docs/getting-started/common-tasks/#shrink-database-files))
+- New Scripts
+  - `import-all.sh`: A script to import all exports (created to automate bulk imports during migration).
+  - `unexpire-accounts.sh:`: Script to unexpire APEX_PUBLIC_USER and workspace accounts (addresses password expiration issues post-migration).
+  - `fix-ws-group-ids.sh` Script to fix p_group_ids in APEX workspace SQL files (resolves a known Oracle bug with group assignments during workspace imports).
+  - `disable-password-expiration.sh`: Script to disable password expiration for APEX workspace accounts (prevents future forced password changes).
+- Enhanced scripts
+  - `backup-user.sh`: Added support for ORDS export directory and schema export.
+  - `import-backup.sh`: Added support for optional remap schema parameter and auto-confirmation flag (-y).
+  - `import-datapump.sh`: Updated usage message and added support for optional remap schema parameter.
+  - `test-script-install.sh`: Added support for auto-confirmation with -y flag.
+  - `test-app-install.sh`: Added support for auto-confirmation with -y flag.
+  - `clear-schema.sh`: Added support for auto-confirmation with -y flag.
+  - `create-user.sh`: Added username validation for hyphens and improved quoting.
 
 ## Migration
 
diff --git a/readme.md b/readme.md
@@ -1,20 +1,20 @@
 # UC Local APEX Dev
 
-**Have a 23ai with APEX and ORDS running in a few minutes**
+**Get Oracle 26ai with APEX and ORDS running in minutes. Automate the tedious parts of local APEX development.**
 
-This set of scripts aims to make developing APEX on your local machine as easy as possible. It is a ready-to-use setup with common tasks automated as bash scripts.
+A containerized development environment (works with Docker, Podman, or any container runtime) that automates common tasks and lets you focus on building APEX applications.
 
 ## Features
 
-- ✅ Create users and workspaces with optimal settings with a single command
-- ✅ All users are stored for easy access with SQLcl or VS Code SQL Developer
-- ✅ Easily delete all data to test installation scripts multiple times
-- ✅ Backup and restore your data, workspaces and apps
-- ✅ Run ORDS with SSL
-- ✅ Test APEX application installs
-- ✅ VS Code SQL Developer debugger support
+- ✅ One-command operations: create users, backups, clear schemas, test installs
+- ✅ Create APEX workspaces and database schemas with optimal development grants
+- ✅ All users automatically registered in SQLcl and VS Code for instant access
+- ✅ Built-in Oracle DataPump backup and restore
+- ✅ ORDS with SSL support for production-like local development
+- ✅ Test APEX application installs repeatedly in isolated test schemas
+- ✅ Full PL/SQL debugging support with VS Code SQL Developer
 
-**This is not for production use!** The environment is configured to be unsecure to make development as easy as possible.
+**⚠️ This is not for production use!** Intentionally unsecure and optimized for ease of development. Passwords stored in plain text, security features relaxed. For local development only.
 
 [Installation Guide](https://www.united-codes.com/products/uc-local-apex-dev/docs/getting-started/)
 
