Troubleshooting

Common issues and their solutions when using fileup.

Common Issues

Configuration File Not Found

If you see an error about the configuration file not being found, make sure you have created the config file at ~/.config/fileup/config.ini.

See the Configuration page for the required format.

FTP Connection Failed

1. Verify your hostname is correct
2. Check that your username and password are correct
3. Ensure the FTP server is accessible from your network
4. Try connecting with a standard FTP client to verify credentials

SCP Connection Failed

1. Verify the hostname matches an entry in your ~/.ssh/config
2. Ensure your SSH key is properly configured
3. Test the connection manually with ssh hostname
4. Check that the destination folder exists on the server

Permission Denied

1. Verify you have write access to the destination folder
2. Check that the base_folder path in your config is correct
3. Ensure your credentials have proper permissions

Limitations

• The automatic clipboard copying feature is only available for macOS users
• FTP passwords are stored in plain text; use with caution
• SCP implementation requires the ssh and scp commands to be available

Getting Help

If you encounter issues not covered here:

1. Check the GitHub Issues for similar problems
2. Open a new issue with details about your setup and the error message