Documentation & Release Notes

Stay up-to-date with the latest features, improvements, and bug fixes for AstraCore. Browse the docs to understand how to get the most out of the platform.

📖 Documentation

1. Installation & First Run
  • Download and run the program.
  • If a .env file does not exist:
    • The program generates a unique authentication token.
    • The token is saved in .env and displayed in the terminal.
    • Important: Copy and keep the token safe!
    • Restart the program so the settings apply.
2. Configuration
  • Port: Default is 6769.
  • Authentication Token: Stored as ASTRA_TOKEN in .env.
  • Panel Integration: Insert the token into your AstraCore Panel.

1. Healthcheck

URL: GET /

Purpose: Confirms the server is running.

curl http://127.0.0.1:6769/

Response: "AstraCore receiver script is healthy and running."

2. Execute Command

URL: POST /execute

Authentication: Include header x-astra-token with your token.

Payload:

{
  "syntax": "ls -la"
}

Example:

curl -X POST http://127.0.0.1:6769/execute \
  -H "x-astra-token: <your_token>" \
  -H "Content-Type: application/json" \
  -d '{"syntax":"ls -la"}'

Response: Output of the command (stdout or stderr).

  • Do not share your token.
  • Only trusted users should have access.
  • Commands run with the permissions of the user running the receiver.

  • Missing or wrong token: 401 Unauthorized
  • Missing command syntax: 400 Bad Request
  • Command fails: Returns the error output.

  1. Start the program. If .env is missing, copy the token and restart.
  2. Use the healthcheck endpoint to verify the server is running.
  3. Use the execute endpoint to run commands with the correct token.
  4. Keep your token secure.

📝 Changelog

❓ FAQ

Q: How do I connect my first server?
A: Simply install the AstraCore agent and use the dashboard to link it with your account.

Q: Is my data encrypted?
A: Yes, we use end-to-end encryption for all communications between your servers and AstraCore.